:ANALyzer:ANALyzeset / query
Executes the analysis operation according to the current setting. The analysis can only be executed when a valid record file is open.
SCPI COMMAND REFERENCE
The Rigol DP831 is Rigol's power supply in the DP800 family. Its SCPI remote-control interface exposes 186 commands across 21 subsystems - 153 settable and 33 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.
186
Commands
153
Settable
33
Queries
21
Subsystems
SCPI
1999.0
Verified
2026-07-16
All commands
186 of 186 commands
:ANALyzer:CURRTimeset / query
Sets the current time of the analyzer, or queries the current time. The current time can only be set when a valid record file is opened.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | Start time - end time of the record file opened | Current time to set for the analyzer. |
integer - Returns the current time of the analyzer.
:ANAL:CURRT 12 :ANAL:CURRT?
:ANALyzer:ENDTimeset / query
Sets or queries the end time of the analyzer. The end time can only be set when a valid record file is open.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | - | End time value to set; refer to the manual for the valid range. |
| qualifieropt | enum | MINimum | MAXimum | Use MINimum or MAXimum instead of a numeric value. |
integer - Returns the current end time of the analyzer.
:ANAL:ENDT 125 :ANAL:ENDT?
:ANALyzer:FILE?query
Queries the record file currently opened. When a valid record file is open, it returns the directory of that file; otherwise it returns NULL.
string - The directory of the currently opened record file, or NULL when no valid record file is open.
:ANALyzer:FILE?
:ANALyzer:MEMoryset / query
Opens the specified record file in the internal memory (C disk). The command is only available when a valid record file is stored in the specified location.
| Name | Type | Values | Description |
|---|---|---|---|
| record file location | discrete | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | Selects which record file location in internal memory to open. |
:ANAL:MEMory 10
:ANALyzer:MMEMoryset / query
Opens the record file in the specified directory on the external memory (D disk). This command is only available when external memory is detected and a valid record file is stored in the specified directory.
| Name | Type | Values | Description |
|---|---|---|---|
| dest | string | - | Valid directory under D disk. |
:ANAL:MMEMory D:\RECORD.ROF
:ANALyzer:OBJectset / query
Sets the analysis object of the analyzer to voltage, current, or power, and queries the current analysis object. The setting is only valid when a record file is open.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | V | C | P | Analysis object to select: voltage, current, or power. |
enum - Returns the current analysis object as V, C, or P.
:ANAL:OBJ V :ANAL:OBJ?
:ANALyzer:RESult?query
Queries the analysis results, including group count, median, mode, average, variance, range, minimum, maximum, and mean deviation.
string - Returns the analysis results as comma-separated labeled fields such as Group, Median, Mode, Average, Variance, Range, Min, Max, and Mean.
:ANAL:RES?
:ANALyzer:STARTTimeset / query
Sets the start time of the analyzer. The start time can only be set when a valid record file is open.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | - | Start time of the record file opened to end time. |
:ANAL:STARTT 1 /*Set the start time to 1s*/ :ANAL:STARTT? /*Query the current start time and the query returns 1*/
:ANALyzer:VALue?query
Queries the voltage, current, and power at a specified time in the opened record file. The command is only valid when a record file is open.
| Name | Type | Values | Description |
|---|---|---|---|
| time | integer | Start time of the record file opened - end time | Time within the opened record file at which to query values. |
string - Returns the voltage, current, and power separated by commas, for example, Volt:1.2817V,Curr:0.0485A,Power:0.0622W.
:ANAL:VAL? 5 /*Query the voltage, current and power at 5s of the record file opened and the query returns Volt:1.2817V,Curr:0.0485A,Power:0.0622W*/
:APPLyset / query
Select the specified channel as the current channel and set its voltage/current, or query the voltage/current of a specified channel. For multi-channel models, it combines channel selection with voltage and current setting functions.
| Name | Type | Values | Description |
|---|---|---|---|
| channel | enum | CH1 | CH2 | CH3 | Specifies the channel to select or query. |
| voltopt | real | MINimum - MAXimum | Sets the voltage of the specified or current channel. |
| curropt | real | MINimum - MAXimum | Sets the current of the specified or current channel. |
| qualifieropt | enum | MINimum | MAXimum | DEF | Selects the minimum, maximum, or default value instead of a numeric voltage or current. |
| channelopt | enum | CH1 | CH2 | CH3 | Specifies the channel to query. |
| modeopt | enum | CURRent | VOLTage | Selects whether the query returns the current or voltage setting. |
string - The query returns a string. Depending on the parameters, it returns either the voltage or current setting value, the channel/range name with rated and setting values, or the voltage and current setting values of the current channel.
:APPL CH1,5,1 /*Set the voltage and current of CH1 to 5V and 1A respectively*/ :APPL? CH1 /*Query the voltage and current setting values of CH1 and the query returns CH1:8V/5A,5.000,1.0000*/
:DELAY:CYCLEsset / query
Sets or queries the number of delay cycles. I selects infinite cycles; N selects finite cycles and an optional value specifies the cycle count.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | N | I | Selects finite cycles (N) or infinite cycles (I). |
| valueopt | integer | 1 - 99999 | Number of cycles when finite cycles are selected. |
enum - Returns the current cycle setting as I or N,<value> (for example, N,100).
:DELAY:CYCLE I /*Set the number of cycles to "Infinite" */ :DELAY:CYCLE N /*Set the number of cycles to 1*/ :DELAY:CYCLE N,100 /*Set the number of cycles to 100*/ :DELAY:CYCLE? /*Query the current number of cycles and the query returns N,100*/
:DELAY:ENDStateset / query
Sets or queries the end state of the delayer. The end state determines the instrument output state when the delayer stops.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | LAST | End state of the delayer. |
enum - Returns the current end state of the delayer.
:DELAY:ENDS LAST :DELAY:ENDS?
:DELAY:GROUPsset / query
Set or query the number of output groups of the delayer. The query returns an integer from 1 to 2048.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 1 - 2048 | Number of output groups of the delayer. |
integer - The current number of output groups.
:DELAY:GROUP 125 :DELAY:GROUP?
:DELAY:PARAmeterset / query
Sets the delayer parameters of the specified group, or queries delayer parameters starting at a specified group. The query returns a string starting with # and the group data formatted as number, output state, and delay time separated by semicolons.
| Name | Type | Values | Description |
|---|---|---|---|
| secnum | integer | 0 - 2047 | Group number of the delayer parameters to be set. |
| state | enum | ON | OFF | Output state of the group. |
| time | integer | 1s - 99999s | Delay time. |
:DELAY:PARA 1,ON,2 :DELAY:PARA? 3,2
:DELAY[:STATe]set / query
Enable or disable the delay output function of the current channel. The query returns the current delay output state.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enable or disable the delay output function. |
enum - The query returns ON or OFF.
:DELAY ON :DELAY?
:DELAY:STATe:GENset / query
Selects the pattern used when generating state automatically. The query returns the current pattern.
| Name | Type | Values | Description |
|---|---|---|---|
| pattern | enum | 01P | 10P | Pattern used when generating state automatically. |
enum - Returns the current pattern used when generating state automatically.
:DELAY:STAT:GEN 10P :DELAY:STAT:GEN?
:DELAY:STOPset / query
Sets or queries the stop condition of the delayer. The stop condition can be NONE or a voltage, current, or power threshold with an optional value; the query returns the current stop condition.
| Name | Type | Values | Description |
|---|---|---|---|
| condition | enum | NONE | <V | >V | <C | >C | <P | >P | Stop condition selection. |
| valueopt | real | 0 - the maximum voltage/current/power of the current channel | Threshold value for the selected voltage, current, or power stop condition. |
:DELAY:STOP >V,8 :DELAY:STOP?
:DELAY:TIME:GENset / query
Sets or queries the method used to generate time automatically and its associated parameters. FIX uses on/off delay times; INC and DEC use a time base value and step.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | FIX | INC | DEC | Selects the automatic time generation method. |
| value0opt | integer | 1s - 99999s | On delay for FIX, or time base value for INC/DEC. |
| value1opt | integer | 1s - 99999s | Off delay for FIX, or step value for INC/DEC. |
string - Returns the method used to generate time automatically and the corresponding parameters in the form method,<value0>,<value1>, for example INC,2,5.
:DELAY:TIME:GEN INC,2,5 :DELAY:TIME:GEN?
:DISPlay:MODEset / query
Sets or queries the display mode. Four modes are documented: number, waveform, dial, and classic.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | NORMal | WAVE | DIAL | CLAS | Display mode to set. |
enum - Returns the current display mode.
:DISP:MODE WAVE :DISP:MODE?
:DISPlay[:WINDow][:STATe]set / query
Turns the screen display off or on. The query returns the current screen display state.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | Screen display state to set. |
enum - The current screen display state.
:DISP OFF :DISP?
:DISPlay[:WINDow]:TEXT:CLEarset / query
Clear the characters displayed on the screen.
:DISP:TEXT:CLE /*Clear the characters displayed on the screen*/
:DISPlay[:WINDow]:TEXT[:DATA]set / query
Displays the specified quoted string at the specified screen coordinate. The query returns the string currently displayed on the screen.
| Name | Type | Values | Description |
|---|---|---|---|
| quoted string | string | - | String enclosed in double quotation marks to display on the screen. |
| coordinate X valueopt | string | 0 - 320 | Horizontal coordinate of the upper-left corner of the string. |
| coordinate Y valueopt | string | 0 - 240 | Vertical coordinate of the upper-left corner of the string. |
string - String enclosed in double quotation marks containing the content actually displayed on the screen.
:DISP:TEXT "RIGOL",25,35 /*Display the string RIGOL from (25,35)*/ :DISP:TEXT? /*Query the string currently display on the screen and the query returns "RIGOL"*/
*CLSset / query
Clear all the event registers.
*ESEset / query
Enables bits in the standard event register enable register. The query returns the decimal sum of the bits currently enabled.
| Name | Type | Values | Description |
|---|---|---|---|
| enable value | integer | 0 | Decimal value corresponding to the sum of the binary weights of the bits to be enabled in the enable register. |
integer - Decimal value corresponding to the sum of the binary weights of the bits currently enabled in the enable register.
*ESE 20 *ESE?
*ESR?query
Queries the standard event register. The command returns a decimal value representing the sum of the binary weights of all set bits and clears the register when read.
integer - Decimal value corresponding to the sum of the binary weights of all bits currently set in the standard event register.
*ESR? /*Query the event register of the standard event register and the query returns 20*/
*IDN?query
Queries the ID string of the instrument.
string - Returns the instrument ID string, consisting of four comma-separated parts in sequence: manufacturer name, instrument model, instrument serial number, and digital board version number.
*OPCset / query
Sets the OPC bit in the standard event register after the current and all previous commands have completed. The query form returns 1 when the current operation is complete and can be used for synchronization.
integer - Returns 1 when the current operation is completed.
*OPC *OPC?
*OPT?query
Queries the installation status of the instrument options. The query returns the installed option names separated by commas, or 0 for an uninstalled option.
string - Returns the installation status of the options, with option names separated by commas. If an option is not installed, the query returns 0.
*OPT?
*PSCset / query
Enables or disables clearing the status byte and standard event register enable registers at power-on. The query returns the current setting as 0 or 1.
| Name | Type | Values | Description |
|---|---|---|---|
| {0|1} | enum | 0 | 1 | Sets whether the enable registers are cleared at power-on. |
enum - Returns the current setting of the power-on status clear function as 0 or 1.
*PSC 1 *PSC?
*RCLset / query
Recalls the instrument state stored in the internal memory. The specified location must be one of the 10 storage locations numbered 1 to 10.
| Name | Type | Values | Description |
|---|---|---|---|
| location | integer | 1 - 10 | Storage location number to recall. |
*RSTset / query
Restores the power supply to factory state and clears the error queue.
*RST
*SAVset / query
Save the current instrument state to the specified storage location in internal memory using the default filename.
| Name | Type | Values | Description |
|---|---|---|---|
| location | discrete | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | Storage location number in the internal memory. |
*SAV 5
*SREset / query
Enables bits in the status byte enable register. The query returns the decimal value corresponding to the bits currently enabled in that register.
| Name | Type | Values | Description |
|---|---|---|---|
| enable value | discrete | - | Decimal value corresponding to the sum of the binary weights of the bits to be enabled in the status byte enable register. |
integer - Decimal value corresponding to the sum of the binary weights of the bits enabled in the status byte enable register.
*SRE 24 *SRE?
*STB?query
Queries the SUMMARY register of the status byte register without clearing it.
integer - Returns a decimal value corresponding to the sum of the binary weights of all the bits in the SUMMARY register of the status byte register.
*STB? /* Query the SUMMARY register of the status byte register and the query returns 72*/
*TRGset / query
Generate a trigger operation. This command is only available when Bus (software) trigger is selected, and it triggers the power supply after the specified trigger delay time when a delay is set.
*TRG
*TST?query
Queries the instrument self-test results. The results include TopBoard, BottomBoard, and fan status, for example: TopBoard:PASS,BottomBoard:PASS,Fan:PASS.
string - The self-test results of TopBoard, BottomBoard, and fan, respectively.
*WAIset / query
Sets the instrument to execute any other command only after all pending operations are completed. It is used for synchronization when BUS trigger (software trigger) is selected.
*WAI /*Set the instrument to executing any other command after all the pending operations are completed*/
:INITiateset / query
Initializes the trigger system. When the trigger type is set to IMM, the instrument executes a complete trigger operation after this command; when set to BUS, it initializes the trigger system for a subsequent *TRG command.
:INSTrument:COUPle[:TRIGger]set / query
Selects the trigger coupling channels for multi-channel models. The query returns the current coupling channels and their rated voltage/current values, or ALL if all channels are coupled.
| Name | Type | Values | Description |
|---|---|---|---|
| list | discrete | ALL | NONE | Channel list to couple for trigger operation. |
string - Returns the names of the current coupling channels and the rated voltage/current values, separated by commas; returns ALL if the coupling channels contain all channels.
:INST:COUP CH1,CH2 /*Set the trigger coupling channels to CH1 and CH2*/ :INST:COUP? /*Query the current trigger coupling channels and the query returns CH1:8V/5A,CH2:30V/2A*/
:INSTrument:NSELectset / query
Selects the current channel on multi-channel models. The query returns which channel is currently selected.
| Name | Type | Values | Description |
|---|---|---|---|
| channel | discrete | 1 - 3 | Selects the current channel number: 1, 2, or 3, representing CH1, CH2, or CH3. |
discrete - Returns the currently selected channel number.
:INST:NSEL 3 :INST:NSEL?
:INSTrument[:SELEct]set / query
Selects the current channel on multi-channel models, and queries the currently selected channel. The command is equivalent to :INSTrument:NSELect and :INSTrument[:SELect].
| Name | Type | Values | Description |
|---|---|---|---|
| channel | enum | CH1 | CH2 | CH3 | Channel to select. |
:INST CH3 /*Select CH3 as the current channel*/ :INST? /*Query the channel currently selected and the query returns CH3:-30V/2A */
:INSTrument[:SELect]set / query
Select the current channel or query the currently selected channel. This command is only applicable to multi-channel models.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | CH1 | CH2 | CH3 | Selects the current channel. |
:INST CH3 /*Select CH3 as the current channel*/ :INST? /*Query the channel currently selected and the query returns CH3:-30V/2A */
:LIC:SETset / query
Installs the options using a unique option license string. The license is a fixed-character ASCII string.
| Name | Type | Values | Description |
|---|---|---|---|
| license | string | - | Option license string required to install an option. |
:LIC:SET UVF2L3N3XXKYTB73PPRSA4XDMSRT
:MEASure:ALL[:DC]?query
Queries the voltage, current, and power measured on the output terminal of the specified channel. If the channel is omitted, it uses the currently selected channel.
| Name | Type | Values | Description |
|---|---|---|---|
| channelopt | enum | CH1 | CH2 | CH3 | Specifies which channel to query. |
string - Returns the measured voltage, current, and power separated by commas.
:MEAS:ALL? CH1
Queries the current measured on the output terminal of the specified channel. If the channel is omitted, it queries the current for the currently selected channel.
| Name | Type | Values | Description |
|---|---|---|---|
| channelopt | discrete | CH1 | CH2 | CH3 | Specifies the channel whose output-terminal current is queried. |
real - The measured current on the output terminal of the specified channel, for example 0.0500.
:MEAS:CURR? CH1
:MEASure:POWEr[:DC]?query
Queries the power measured on the output terminal of the specified channel. If the channel is omitted, it queries the power on the currently selected channel.
| Name | Type | Values | Description |
|---|---|---|---|
| channelopt | enum | CH1 | CH2 | CH3 | Specifies which output channel to query. |
real - The power measured on the output terminal of the specified channel, for example 0.100.
:MEAS:POWE? CH1 /*Query the power measured on the output terminal of CH1 and the query returns 0.100*/
Queries the voltage measured on the output terminal of the specified channel. If the channel argument is omitted, it queries the channel currently selected.
| Name | Type | Values | Description |
|---|---|---|---|
| channelopt | enum | CH1 | CH2 | CH3 | Specifies which channel's output-terminal voltage to measure. |
real - Returns the measured output-terminal voltage for the specified channel, for example 2.0000.
:MEAS? CH1
:MEMory[:STATe]:DELeteset / query
Deletes the file stored in the specified internal memory location. The file type can be state, record, timer, or delay file.
| Name | Type | Values | Description |
|---|---|---|---|
| file type | enum | RSF | ROF | RTF | RDF | Specifies the file type to delete. |
| location | integer | 1 - 10 | Specifies the storage location number in internal memory. |
:MEM:DEL RSF,5 /*Delete the file currently stored in storage location 5 of state notes Related :MEMory[:STATe]:LOCK
:MEMory[:STATe]:LOADset / query
Reads the specified file stored in internal memory. The file type can be state, timer, or delay file, and the location is selected by number 1 through 10.
| Name | Type | Values | Description |
|---|---|---|---|
| file type | enum | RSF | RTF | RDF | Specifies the file type to load. |
| location | enum | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | Selects the storage location in internal memory. |
:MEM:LOAD RSF,5 /*Read the file currently stored in storage location 5 of state files in the internal memory */
:MEMory[:STATe]:LOCKset / query
Locks or unlocks the file in a specified internal-memory storage location. The query reports whether the file is locked and returns YES or NO.
| Name | Type | Values | Description |
|---|---|---|---|
| file type | enum | RSF | ROF | RTF | RDF | Selects the file type to lock or query. |
| location | integer | 1 - 10 | Selects the storage location in internal memory. |
| state | enum | ON | OFF | Locks or unlocks the specified file. |
enum - Returns YES if the specified file is locked, or NO if it is unlocked or if no file has been stored in the specified location.
:MEM:LOCK RSF,5,ON /*Lock the file currently stored in storage location 5 of :MEM:LOCK? RSF,5 /*Query the locking state of the file currently stored in
:MEMory[:STATe]:STOReset / query
Saves the specified file type to the specified internal-memory storage location using the default filename. The file type can be state (RSF), timer (RTF), or delay (RDF).
| Name | Type | Values | Description |
|---|---|---|---|
| file type | enum | RSF | RTF | RDF | Specifies the type of file to save. |
| location | enum | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | Specifies the internal-memory storage location. |
:MEM:STOR RSF,5
Query whether a valid file has been stored in the specified storage location in internal memory. The query returns YES or NO.
| Name | Type | Values | Description |
|---|---|---|---|
| file type | enum | RSF | ROF | RTF | RDF | Type of file to check. |
| location | integer | 1 - 10 | Storage location in internal memory. |
enum - YES if a valid file has been stored in the specified location; NO otherwise.
:MEM:VAL? RSF,5 /*Query whether a valid file has been stored in storage location 5 of state files in the internal memory and the query returns YES*/
:MMEMory:CATalog?query
Queries all files and folders stored in the external storage directory (D disk). It is only valid when external memory is detected and the current directory is the external memory or a folder within it.
string - Returns the names of all files and folders stored in the external memory, separated by commas.
:MMEMory:CDIRectoryset / query
Sets the current operation directory or queries the current operation directory. This command is only applicable to external memory and is valid only when external memory (D disk) is detected.
| Name | Type | Values | Description |
|---|---|---|---|
| directory_name | string | - | Valid external-memory directory to set as the current operation directory. |
string - Returns the current operation directory, for example, D:\RIGOL.
:MMEM:CDIR D:\RIGOL :MMEM:CDIR?
:MMEMory:DELeteset / query
Delete the specified file or empty folder under the current operation directory. This command is only applicable to external memory and is valid only when the current directory is the external memory or a folder in the external memory.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | Filenames of the files stored in the current operation directory |
:MMEM:DEL STA.RSF /*Delete the STA.RSF file under the current operation directory*/
:MMEMory:DISK?query
Query the drive letter of the external memory available of the power supply.
string - Returns the drive letter available, for example, D:\.
:MMEM:DISK? /*Query the drive letter of the external memory available and the query returns D:\*/
:MMEMory:LOADset / query
Read the specified file under the current operation directory. This command is only applicable to external memory and is valid only when the current directory is the external memory or a folder in it.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | Filenames of the files stored in the current operation directory. |
:MMEM:LOAD STA.RSF /*Read the STA.RSF file under the current operation directory*/
:MMEMory:MDIRectoryset / query
Creates a new folder under the current operation directory. It is only applicable to external memory and valid only when the current directory is the external memory.
| Name | Type | Values | Description |
|---|---|---|---|
| dir_name | string | - | Name of the folder to be created; up to 9 characters, including Chinese characters, English characters, or numbers. |
:MMEM:MDIR NEW /*Create a folder with the name NEW under the current operation directory*/
:MMEMory:STOReset / query
Save the file with the specified filename under the current operation directory.
| Name | Type | Values | Description |
|---|---|---|---|
| <file_name> | string | - | Filename to create, including the name and file type. |
:MMEM:STOR STB.RSF
:MONItor:CURRent:CONDitionset / query
Sets or queries the current monitor condition for the current channel. The condition consists of a current threshold relation and a logic relation.
| Name | Type | Values | Description |
|---|---|---|---|
| condition | enum | <C | >C | NONE | Current monitor threshold condition. |
| logic | enum | AND | OR | NONE | Logic relation used with the monitor condition. |
string - Returns the current monitor condition and logic relation separated by a comma, for example, <C,AND.
:MONI:CURR:COND <C,AND :MONI:CURR:COND?
:MONItor:CURRent[:VALue]set / query
Sets or queries the current value of the monitor condition for the current channel.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | 0 - the maximum current of the current channel | Current monitor value to set. |
| qualifieropt | enum | MINimum | MAXimum | Query qualifier to return the minimum or maximum current value. |
real - The current of the monitor condition (the current channel), for example, 4.0000.
:MONI:CURR 4 /*Set the current value of the monitor condition (the current :MONI:CURR? /*Query the current value of the monitor condition (the current
:MONItor:POWER:CONDitionset / query
Sets or queries the power monitor condition of the current channel. The condition can be set to <P, >P, or NONE.
| Name | Type | Values | Description |
|---|---|---|---|
| condition | enum | <P | >P | NONE | Power monitor condition to apply. |
enum - Returns the current power monitor condition, for example, <P.
:MONI:POWER:COND <P :MONI:POWER:COND?
:MONItor:POWER[:VALue]set / query
Sets or queries the power value of the monitor condition for the current channel. For multi-channel models, the valid range is from 0 to the channel maximum power; for single-channel models, it is from 0 to the current range maximum power.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | 0 | Power value of the monitor condition. |
| qualifieropt | enum | MINimum | MAXimum | Optional keyword qualifier for setting or querying the power value. |
real - Returns the power of the current monitor condition (the current channel).
:MONI:POWER 20 :MONI:POWER?
:MONItor[:STATe]set / query
Enable or disable the monitor for the current channel. Queries the current monitor state.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables the monitor. |
enum - Returns ON or OFF indicating the monitor state.
:MONI ON :MONI?
:MONItor:STOPwayset / query
Sets or queries the monitor stop modes for the current channel. When enabled, the instrument can turn off output, display a prompt message, or sound the beeper according to the selected stop mode.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | OUTOFF | WARN | BEEPER | Selects which stop mode to set. |
| state | enum | ON | OFF | Enables or disables the selected stop mode. |
string - Returns the on/off status of the three stop modes separated by commas, for example OutputOff:ON,Warn:ON,Beep:ON.
:MONI:STOP OUTOFF,ON /*Enable the "OutpOff" stop mode*/ :MONI:STOP WARN,ON /*Enable the "Warning" stop mode*/ :MONI:STOP BEEPER,OFF /*Disable the "Beeper" stop mode*/ :MONI:STOP? /*Query the current stop modes of the monitor and the query returns OutputOff:ON,Warn:ON,Beep:OFF*/
:MONItor:VOLTage:CONDitionset / query
Sets or queries the voltage monitor condition for the current channel. The condition is a combination of the voltage threshold state and a logic relation.
| Name | Type | Values | Description |
|---|---|---|---|
| condition | enum | <V | >V | NONE | Voltage monitor condition: below voltage, above voltage, or disabled. |
| relation | enum | AND | OR | NONE | Logic relation used to combine monitor conditions. |
string - Returns the voltage monitor condition and logic relation separated by a comma, for example, <V,AND.
:MONI:VOLT:COND <V,AND :MONI:VOLT:COND?
:MONItor:VOLTage[:VALue]set / query
Sets or queries the voltage value of the monitor condition for the current channel. The query returns the current monitor-condition voltage, such as 5.000.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | 0 - the maximum voltage of the current channel | Voltage value to set for the monitor condition of the current channel. |
| qualifieropt | enum | MINimum | MAXimum | Optional query qualifier to return the minimum or maximum monitor voltage. |
real - The voltage of the current monitor condition (current channel).
:MONI:VOLT 5 :MONI:VOLT?
:OUTPut:CVCC?query
Queries the current output mode of the specified channel. When the channel is omitted, it queries the current channel.
| Name | Type | Values | Description |
|---|---|---|---|
| channelopt | enum | CH1 | CH2 | CH3 | Channel to query. |
enum - Returns the output mode of the selected channel.
:OUTP:CVCC? CH1
:OUTPut:MODE?query
Queries the current output mode of the specified channel. If the channel is omitted, the current channel is queried.
| Name | Type | Values | Description |
|---|---|---|---|
| channelopt | enum | CH1 | CH2 | CH3 | Channel whose output mode is queried. |
enum - Returns the output mode of the selected channel.
:OUTP:MODE? CH1
:OUTPut:OCP:ALAR?query
Queries whether overcurrent protection (OCP) occurred on the specified channel. If the channel is omitted, the current channel is queried.
| Name | Type | Values | Description |
|---|---|---|---|
| channelopt | discrete | CH1 | CH2 | CH3 | Channel to query for OCP occurrence. |
enum - Indicates whether OCP occurred on the queried channel.
:OUTP:OCP:ALAR? CH1
:OUTPut:OCP:QUES?query
Queries whether overcurrent protection (OCP) occurred on the specified channel. When the channel is omitted, the current channel is queried.
| Name | Type | Values | Description |
|---|---|---|---|
| channelopt | enum | CH1 | CH2 | CH3 | Channel to query for OCP occurrence. |
enum - Indicates whether OCP occurred.
:OUTP:OCP:QUES? CH1
:OUTPut:OCP:CLEARset / query
Clears the label of the overcurrent protection event on the specified channel. If the channel is omitted, the current channel is used.
| Name | Type | Values | Description |
|---|---|---|---|
| channelopt | discrete | CH1 | CH2 | CH3 | Specifies the channel whose OCP label is cleared. |
:OUTP:OCP:CLEAR CH1
:OUTPut:OCP[:STATe]set / query
Enable or disable the overcurrent protection (OCP) function of the specified channel. The query returns the OCP status of the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| channelopt | enum | CH1 | CH2 | CH3 | Specifies the channel to operate on; if omitted, the current channel is used. |
| state | enum | ON | OFF | Enables or disables overcurrent protection. |
enum - Returns ON or OFF to indicate the overcurrent protection status of the specified channel.
:OUTP:OCP CH1,ON :OUTP:OCP? CH1
:OUTPut:OCP:VALueset / query
Sets or queries the overcurrent protection value for a specified channel. If no channel is given, the current channel is used.
| Name | Type | Values | Description |
|---|---|---|---|
| channelopt | enum | CH1 | CH2 | CH3 | Channel to apply the operation to. |
| value | real | - | Overcurrent protection value to set. |
real - Returns the overcurrent protection value, for example 5.0000.
:OUTP:OCP:VAL CH1,5 /*Set the OCP value of CH1 to 5A*/ :OUTP:OCP:VAL? CH1 /*Query the OCP value of CH1 and the query returns 5.0000*/
:OUTPut:OVP:ALAR?query
Queries whether OVP occurred on the specified channel. If the channel is omitted, the current channel is queried.
| Name | Type | Values | Description |
|---|---|---|---|
| channelopt | enum | CH1 | CH2 | CH3 | Channel to query for OVP occurrence. |
enum - Indicates whether OVP occurred on the specified channel.
:OUTP:OVP:ALAR? CH1
:OUTPut:OVP:QUES?query
Queries whether OVP occurred on the specified channel. When the channel is omitted, the current channel is queried.
| Name | Type | Values | Description |
|---|---|---|---|
| channelopt | enum | CH1 | CH2 | CH3 | Channel to query for OVP occurrence. |
enum - Returns YES if OVP occurred, or NO if it did not.
:OUTP:OVP:QUES? CH1
:OUTPut:OVP:CLEARset / query
Clears the label of the overvoltage protection condition on the specified channel. If the channel is omitted, the current channel is used.
| Name | Type | Values | Description |
|---|---|---|---|
| channelopt | discrete | CH1 | CH2 | CH3 | Specifies which channel's OVP label to clear. |
:OUTP:OVP:CLEAR CH1
:OUTPut:OVP[:STATe]set / query
Enables or disables the overvoltage protection (OVP) function of the specified channel. The query returns the OVP status of the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| channelopt | discrete | CH1 | CH2 | CH3 | Specifies the channel to apply the command to; if omitted, the current channel is used. |
| state | boolean | ON | OFF | Enables or disables OVP. |
enum - Returns ON or OFF, indicating the status of the overvoltage protection function on the specified channel.
:OUTP:OVP CH1,ON :OUTP:OVP? CH1
:OUTPut:OVP:VALueset / query
Sets the overvoltage protection (OVP) value for the specified channel, or for the current channel if the channel is omitted. The query returns the OVP value of the specified or current channel.
| Name | Type | Values | Description |
|---|---|---|---|
| channelopt | discrete | CH1 | CH2 | CH3 | Specifies the channel whose OVP value is set or queried. |
| value | real | Refer to Table 2-2 | OVP value to set. |
real - Returns the overvoltage protection value, for example, 8.800.
:OUTP:OVP:VAL CH1,8.8 /*Set the overvoltage protection value of CH1 to 8.8V*/ :OUTP:OVP:VAL? CH1 /*Query the overvoltage protection value of CH1 and the query returns 8.800*/
:OUTPut:RANGeset / query
Selects the current range of the channel. The query returns the rated voltage and current values of the currently selected range.
| Name | Type | Values | Description |
|---|---|---|---|
| range | enum | P8V | P20V | P40V | LOW | HIGH | Selects the channel range. |
string - Returns the rated voltage and current values of the range selected, for example 20V/10A.
:OUTP:RANG P20V /*Select Range1: 20V/10A as the current range*/ :OUTP:RANG? /*Query the range currently selected and the query returns 20V/10A*/ :OUTP:RANG HIGH /*Select Range2: 40V/5A as the current range*/ :OUTP:RANG? /*Query the range currently selected and the query returns 40V/5A*/
:OUTPut:SENSeset / query
Enable or disable the Sense function of the specified channel. The query returns the Sense status of the channel, or NONE for channels that do not support Sense.
| Name | Type | Values | Description |
|---|---|---|---|
| channelopt | enum | CH1 | CH2 | CH3 | Specifies the channel to control or query. |
| state | enum | ON | OFF | Enables or disables the Sense function. |
enum - Returns ON or OFF for supported channels; returns NONE for channels that do not support the Sense function.
:OUTP:SENS CH1,ON :OUTP:SENS? CH1
:OUTPut[:STATe]set / query
Enable or disable the output of the specified channel. Query the output status of the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| [CH1|CH2|CH3]opt | enum | CH1 | CH2 | CH3 | Specifies the channel to control; when omitted, the current channel is used. |
| state | enum | ON | OFF | Enables or disables the output. |
enum - Returns the output status of the specified channel.
:OUTP CH1,ON
:OUTPut:TIMErset / query
Sets the specified group of timer parameters for the specified channel. The query returns the first 5 groups of timer parameters (group numbers 0 to 4) for the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| channel | enum | P8V | P30V | N30V | Specified channel. |
| secnum | integer | 0 - 2047 | Group number of the specified group of timer parameters. |
| volt | real | V | Voltage of this group of timer parameters. |
| curr | real | A | Current of this group of timer parameters. |
| time | real | 1 - 99999 | Time of this group of timer parameters. |
:OUTPut:TIMEr:STATeset / query
Turns the timer output function on or off for the specified channel. The query returns the current timer output state of the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| channel | enum | P8V | P30V | N30V | Specified channel. |
| state | enum | ON | OFF | Turns the timer output function on or off. |
enum - The query returns ON or OFF.
:OUTP:TIME:STAT P8V,ON :OUTP:TIME:STAT? P8V
:OUTPut:TRACkset / query
Enables or disables the track function of the specified channel. The query returns the track status of the specified channel, or NONE for channels that do not support track.
| Name | Type | Values | Description |
|---|---|---|---|
| channelopt | discrete | CH1 | CH2 | CH3 | Specified channel to control or query. |
| state | boolean | ON | OFF | Turns the track function on or off. |
enum - Returns ON or OFF for supported channels; returns NONE for channels that do not support the track function.
:OUTP:TRAC CH2,ON /*Enable the track function of CH2 of DP831A*/ :OUTP:TRAC? CH2 /*Query the status of the track function of CH2 of DP831A and the query returns ON*/
:PRESet[:APPLy]set / query
Restore the instrument to the default setting or recall the specified user-defined setting. Sending this command is equivalent to pressing Preset on the front panel, and the setting recalled depends on :PRESet:KEY.
:PRESet:KEYset / query
Defines which setting is recalled by Preset on the front panel. The query returns the currently selected preset setting.
| Name | Type | Values | Description |
|---|---|---|---|
| setting | enum | DEFAULT | USER1 | USER2 | USER3 | USER4 | Setting recalled by Preset on the front panel. |
enum - Returns the preset setting recalled by Preset on the front panel.
:PRES:KEY USER1 /*Define the setting recalled by Preset on the front panel to :PRES:KEY? /*Query the setting recalled by Preset on the front panel and
:PRESet:USER[<n>]:SET:CURRentset / query
Sets the current value of the current channel in the specified user-defined setting. The query returns the current value.
| Name | Type | Values | Description |
|---|---|---|---|
| <n>opt | discrete | 1 - 4 | Selects the first, second, third, or fourth user-defined setting group. |
| <current> | real | A | Current value to set for the current channel. |
| qualifier | enum | MINimum | MAXimum | Optional query qualifier; returns the minimum or maximum current value. |
real (A) - The current value of the current channel in the specified user-defined setting.
:PRES:USER1:SET:CURR 1.5 :PRES:USER1:SET:CURR?
:PRESet:USER[<n>]:SET:DEFaultset / query
Restores the parameters of the specified user-defined setting to default values. If <n> is omitted, the currently selected user-defined setting is restored.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | discrete | 1 - 4 | Specifies which user-defined setting group to restore: 1, 2, 3, or 4. |
:PRESet:USER[<n>]:SET:OCPset / query
Enables or disables the overcurrent protection function of the current channel in a specified user-defined setting, and sets the OCP value. The query returns the OCP status and value for the current channel in that user-defined setting.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 4 | Selects the first, second, third, or fourth user-defined setting group; omitted uses the currently selected default group. |
| state | boolean | ON | OFF | Enables or disables the overcurrent protection function. |
| currentopt | real | 0.1mA - 11A | Sets the OCP value for the current channel; the exact range and default depend on the model. |
| qualifieropt | enum | MINimum | MAXimum | Sets the OCP value to the minimum or maximum allowed value. |
enum - Returns the OCP status and value of the current channel in the specified user-defined setting, separated by a comma, for example ON,1.5000.
:PRES:USER1:SET:OCP ON,1.5 :PRES:USER1:SET:OCP?
:PRESet:USER[<n>]:SET:OTPset / query
Enables or disables the over-temperature protection (OTP) function of the specified user-defined setting. The query returns the current OTP state for the specified user-defined setting.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | discrete | 1 - 4 | Selects the first, second, third, or fourth user-defined setting group; omitted to use the currently selected group by default. |
| state | boolean | ON | OFF | Enables or disables OTP. |
enum - Returns the current OTP status.
:PRES:USER1:SET:OTP ON /*Enable the OTP function of the first group of the user-defined setting*/ :PRES:USER1:SET:OTP? /*Query the status of the OTP function of the first group of the user-defined setting and the query returns ON*/
:PRESet:USER[<n>]:SET:OVPset / query
Enables or disables the overvoltage protection (OVP) function of the current channel in the specified user-defined setting and sets the OVP value. The query returns the OVP status and value for the current channel in the specified user-defined setting.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 4 | Selects user-defined setting group 1 through 4; omitted uses the currently selected user-defined setting. |
| state | boolean | ON | OFF | Enables or disables the OVP function. |
| voltageopt | real | 1mV - 44V | Sets the OVP value for the current channel. |
| qualifieropt | enum | MINimum | MAXimum | Returns the minimum or maximum OVP value when used with the query. |
string - Returns the OVP status and value separated by a comma, for example ON,8.800.
:PRES:USER1:SET:OVP ON,8.8 :PRES:USER1:SET:OVP?
:PRESet:USER[<n>]:SET:SUREset / query
Confirms the parameter and status settings of the specified user-defined setting. Executing it saves the channel voltage, current, OVP and OCP status and values, channel track status, and OTP status for the selected user-defined setting.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | discrete | 1 - 4 | Selects the first, second, third, or fourth group of user-defined setting; when omitted, the currently selected user-defined setting is used. |
:PRES:USER1:SET:SURE
:PRESet:USER[<n>]:SET:TRACkset / query
Enables or disables the track function of the current channel in the specified user-defined setting. The query returns the track status for the current channel in the specified user-defined setting.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 4 | Selects the user-defined setting group to apply the command to; when omitted, the default selected setting is used. |
| state | enum | ON | OFF | Turns the track function on or off. |
enum - Returns ON or OFF for supported channels; returns NONE for channels that do not support the track function.
:PRES:USER1:SET:TRAC ON :PRES:USER1:SET:TRAC?
:PRESet:USER[<n>]:SET:VOLTageset / query
Sets or queries the voltage of the current channel for the specified user-defined setting. The setter accepts a numeric voltage value or the keywords MINimum or MAXimum; the query can optionally request MINimum or MAXimum.
| Name | Type | Values | Description |
|---|---|---|---|
| <n>opt | discrete | 1 - 4 | Selects user-defined setting group 1 through 4; if omitted, the currently selected group is used. |
| <voltage> | real | - | Voltage of the current channel. |
| qualifieropt | enum | MINimum | MAXimum | When used with the setter, specifies the minimum or maximum allowed voltage; when used with the query, requests the minimum or maximum voltage. |
real - Returns the voltage of the current channel, for example 5.000.
:PRES:USER1:SET:VOLT 5 /*Set the voltage of the current channel in the first group of user-defined setting to 5V*/ :PRES:USER1:SET:VOLT? /*Query the voltage of the current channel in the first group of user-defined setting and the query returns 5.000*/
:RECAll:LOCalset / query
Recalls an instrument state file stored in the specified storage location in the internal memory of the instrument.
| Name | Type | Values | Description |
|---|---|---|---|
| {1|2|3|4|5|6|7|8|9|10} | enum | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | Selects the corresponding storage location in the internal memory. |
:RECA:LOC 1 /*Recall the instrument state file stored in storage location 1 in the internal memory of the instrument*/
:RECAll:EXTErnalset / query
Recalls the instrument state file stored in the root directory of the external memory. The file name is specified without the ".RSF" suffix.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | Filename of the state file to recall from external memory, without the ".RSF" suffix. |
:RECA:EXTE STA
Queries the storage directory of the record file.
string - Returns the current storage directory of the record file, for example, C:\REC10:RIGOL.ROF.
:RECorder:MEMoryset / query
Stores the record file to the specified storage location in the internal memory with the specified filename.
| Name | Type | Values | Description |
|---|---|---|---|
| location | integer | 1 - 10 | Record file storage location in internal memory. |
| filename | string | - | Filename of the record file; format is <name>.ROF and the suffix may be omitted. |
:REC:MEM 5,TEST1
:RECorder:MMEMoryset / query
Stores the record file to the specified storage directory in external memory. This command is only available when a USB storage device (D disk) is detected.
| Name | Type | Values | Description |
|---|---|---|---|
| dest | string | - | Specifies the storage directory in external memory; the format is <name>.ROF and the suffix cannot be omitted. |
:REC:MMEM D:\RA.ROF /*Store the record file to the external memory with the filename "RA.ROF"*/
:RECorder:PERIodset / query
Sets the record period of the recorder, or queries the current record period. The period is the time interval at which the instrument samples and records each channel when the recorder is enabled.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 1s - 99999s | Record period to set. |
integer (s) - Returns the current record period in seconds.
:REC:PERI 5 :REC:PERI?
:RECorder[:STATe]set / query
Enable or disable the recorder, or query its current status.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Turns the recorder on or off. |
enum - Returns the recorder status as ON or OFF.
:REC ON /*Enable the recorder*/ :REC? /*Query the current status of the recorder and the query returns ON*/
Queries the condition register of the questionable status register. It returns a decimal value equal to the sum of the binary weights of all bits in the register.
integer - Decimal value corresponding to the sum of the binary weights of all the bits in the register.
:STAT:QUES:COND? /*Query the condition register of the questionable status register and the query returns 1*/
:STATus:QUEStionable:ENABleset / query
Enables the bits in the enable register of the questionable status register. The query returns the decimal value corresponding to the bits currently enabled in that register.
| Name | Type | Values | Description |
|---|---|---|---|
| enable value | discrete | - | Decimal value corresponding to the sum of the binary weights of the bits to be enabled in the questionable status enable register. |
integer - Decimal value corresponding to the sum of the binary weights of the bits currently enabled in the enable register of the questionable status register.
:STAT:QUES:ENAB 17 /*Enable bit0 and bit4 in the enable register of the questionable status register*/ :STAT:QUES:ENAB? /*Query the bits currently enabled in the enable register of the questionable status register and the query returns 17*/
Queries the event register of the questionable status register. The command returns a decimal value corresponding to the sum of the binary weights of the bits in the register and clears the register.
integer - Decimal value corresponding to the sum of the binary weights of all bits in the questionable status event register; reading the register clears it.
:STAT:QUES? /*Query the event register of the questionable status register and the query returns 17*/
:STATus:QUEStionable:INSTrument:ENABleset / query
Enables bits in the enable register of the channel questionable status register. The query returns the decimal value corresponding to the enabled bits.
| Name | Type | Values | Description |
|---|---|---|---|
| enable value | discrete | - | Decimal value corresponding to the sum of the binary weights of the bits to be enabled in the enable register of the channel questionable status register. |
integer - Decimal value corresponding to the sum of the binary weights of the bits enabled in the enable register of the channel questionable status register.
:STAT:QUES:INST:ENAB <14> /*Enable bit1, bit2 and bit3 (INST(n) event summary, event SUMMARY bit of CH(n), n is 1, 2 and 3) in the enable register of the channel questionable status register*/ :STAT:QUES:INST:ENAB? /* Query the bits currently enabled in the enable register of the channel questionable status register and the query returns 14*/
Queries the event register of the channel questionable status register. The returned decimal value is the sum of the binary weights of all set bits, and reading the register clears its status.
integer - Decimal value corresponding to the sum of the binary weights of all bits in the register; reading the register clears it.
:STAT:QUES:INST? /* Query the event register of the channel questionable status status register and the query returns 10*/
Queries the condition register of the specified channel questionable status SUMMARY register. On multi-channel models, the optional channel index selects CH1, CH2, or CH3; if omitted, the current channel is used.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 3 | Selects the questionable status SUMMARY register for CH1, CH2, or CH3. |
integer - Returns a decimal value corresponding to the sum of the binary weights of all bits in the register.
:STAT:QUES:INST:ISUM1:COND? /*Query the condition register of the CH1 questionable status SUMMARY register and the query returns 1*/
Enables bits in the enable register of the channel questionable status SUMMARY register. On query, returns the decimal sum of the enabled bit weights; when <enable value> is 0, the register is cleared.
| Name | Type | Values | Description |
|---|---|---|---|
| <n>opt | discrete | 1 - 3 | Selects the questionable status SUMMARY register for CH1, CH2, or CH3 on multi-channel models. |
| enable value | discrete | - | Decimal value corresponding to the sum of the binary weights of the bits to enable in the register. |
integer - Returns the decimal value corresponding to the sum of the binary weights of the bits currently enabled in the enable register.
:STAT:QUES:INST:ISUM1:ENAB 9 /*Enable bit0 (Voltage, CC mode) and bit3 :STAT:QUES:INST:ISUM1:ENAB? /*Query the bits enabled in the enable
Queries the event register of the specified channel SUMMARY questionable status register. The register is latched and reading it clears the status; on multi-channel models, <n> selects CH1, CH2, or CH3, and when omitted the current channel is used.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | discrete | 1 - 3 | Selects the channel SUMMARY questionable status register: 1 for CH1, 2 for CH2, or 3 for CH3. |
numeric - Returns a decimal value corresponding to the sum of the binary weights of all bits in the event register, and clears the register.
:STAT:QUES:INST:ISUM1? /*Query the event register of the CH1 questionable status SUMMARY register and the query returns 1*/
:STORe:LOCalset / query
Stores the current instrument state to a specified location in internal memory using the specified filename. If a state file already exists at that location, it is overwritten unless the location is locked.
| Name | Type | Values | Description |
|---|---|---|---|
| location | discrete | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | Internal memory storage location to use. |
| file_name | string | - | Specified filename without the .RSF suffix. |
:STOR:LOC 1,123
:STORe:EXTErnalset / query
Stores the current instrument state to the root directory of the external memory using the specified filename. The filename does not include the .RSF suffix and must not exceed 17 bytes; an existing file with the same name is not overwritten.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | Specified filename for the stored state file. |
:STOR:EXTE 123
:SYSTem:BEEPer:IMMediateset / query
Immediately sounds the beeper when the command is sent.
:SYSTem:BEEPer[:STATe]set / query
Enable or disable the beeper. The query returns the current beeper status.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables the beeper. |
enum - Returns the beeper status as ON or OFF.
:SYST:BEEP ON :SYST:BEEP?
:SYSTem:BRIGhtnessset / query
Set or query the screen brightness. The setter accepts an integer brightness value or the keywords MINimum and MAXimum; the query returns the current brightness as an integer and may be qualified with MINimum or MAXimum.
| Name | Type | Values | Description |
|---|---|---|---|
| brightness | integer | 1 - 100 | Brightness level of the screen. |
| qualifieropt | enum | MINimum | MAXimum | Optional query qualifier to request the minimum or maximum brightness value. |
integer - Returns the current screen brightness, or the minimum/maximum brightness when queried with MINimum or MAXimum.
:SYST:BRIG 60 :SYST:BRIG?
:SYSTem:COMMunicate:GPIB:ADDRessset / query
Sets the GPIB address, or queries the current GPIB address when used with '?'.
| Name | Type | Values | Description |
|---|---|---|---|
| gpibaddress | integer | 0 - 30 | GPIB address to set. |
integer - The query returns the current GPIB address.
:SYST:COMM:GPIB:ADDR 7 /*Set the GPIB address*/ :SYST:COMM:GPIB:ADDR? /*Query the current GPIB address and the query returns 7*/
:SYSTem:COMMunicate:LAN:APPLyset / query
Applies the network parameters currently set. The new settings take effect only after this command is executed.
:SYST:COMM:LAN:APPL /*Apply the network parameters currently set*/
:SYSTem:COMMunicate:LAN:AUTOip[:STATe]set / query
Enables or disables the auto IP configuration mode. The new setting takes effect only after :SYSTem:COMMunicate:LAN:APPLy is executed.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Turns auto IP configuration mode on or off. |
enum - Returns the status of the auto IP configuration mode.
:SYST:COMM:LAN:AUTO ON /*Enable the auto IP configuration mode*/ :SYST:COMM:LAN:AUTO? /*Query the status of the auto IP configuration mode and the query returns ON*/
:SYSTem:COMMunicate:LAN:DHCP[:STATe]set / query
Enables or disables DHCP mode for LAN communication. The new setting takes effect only after :SYSTem:COMMunicate:LAN:APPLy is executed.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Sets the DHCP mode state. |
enum - Returns the current DHCP mode status.
:SYST:COMM:LAN:DHCP ON /*Enable the DHCP mode*/ :SYST:COMM:LAN:DHCP? /*Query the status of the DHCP mode and the query returns ON*/
:SYSTem:COMMunicate:LAN:DNSset / query
Sets the DNS (Domain Name Service) address, or queries the current DNS address. The setting only takes effect after :SYSTem:COMMunicate:LAN:APPLy is executed, and the command is only available when manual IP configuration mode is enabled.
| Name | Type | Values | Description |
|---|---|---|---|
| dns | string | - | DNS address in nnn.nnn.nnn.nnn format. |
string - Returns the current DNS address, for example 172.16.3.2.
:SYST:COMM:LAN:DNS 172.16.3.2 /*Set the DNS address to 172.16.3.2*/ :SYST:COMM:LAN:DNS? /*Query the current DNS address and the query notes
:SYSTem:COMMunicate:LAN:GATEwayset / query
Sets the default gateway or queries the current default gateway. The command is only available when manual IP configuration mode is enabled, and the new setting takes effect after :SYSTem:COMMunicate:LAN:APPLy is executed.
| Name | Type | Values | Description |
|---|---|---|---|
| gateway | string | - | Default gateway address in nnn.nnn.nnn.nnn format. |
:SYST:COMM:LAN:GATE 172.16.3.1 :SYST:COMM:LAN:GATE?
:SYSTem:COMMunicate:LAN:IPADdressset / query
Sets the IP address, or queries the current IP address. The command is only available when manual IP configuration mode is enabled, and the new setting takes effect after :SYSTem:COMMunicate:LAN:APPLy is executed.
| Name | Type | Values | Description |
|---|---|---|---|
| ip | string | - | IP address in nnn.nnn.nnn.nnn format. |
string - Returns the current IP address, for example 172.16.3.128.
:SYST:COMM:LAN:IPAD 172.16.3.128 /*Set the IP address*/ :SYST:COMM:LAN:IPAD? /*Query the current IP address and the query returns 172.16.3.128*/
Queries the MAC address of the instrument. The returned MAC (hardware) address is a 48-bit hexadecimal value, typically shown in six-byte form such as 00-2A-A0-AA-E0-56.
string - Returns the MAC address, for example, 00-2A-A0-AA-E0-56.
:SYSTem:COMMunicate:LAN:MANualip[:STATe]set / query
Enables or disables the manual IP configuration mode. In manual IP configuration mode, users define network parameters such as the IP address; the new setting takes effect only after :SYSTem:COMMunicate:LAN:APPLy is executed.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Turns manual IP configuration mode on or off. |
enum - Returns the status of the manual IP configuration mode.
:SYST:COMM:LAN:MAN ON /*Enable the manual IP configuration mode*/ :SYST:COMM:LAN:MAN? /*Query the status of the manual IP configuration mode and the query returns ON*/
:SYSTem:COMMunicate:LAN:SMASKset / query
Sets the subnet mask for LAN configuration, or queries the current subnet mask. The command is only available when manual IP configuration mode is enabled, and the new setting takes effect after :SYSTem:COMMunicate:LAN:APPLy is executed.
| Name | Type | Values | Description |
|---|---|---|---|
| submask | string | - | Subnet mask in nnn.nnn.nnn.nnn format, with each nnn ranging from 0 to 255. |
string - Returns the current subnet mask, for example 255.255.255.0.
:SYST:COMM:LAN:SMASK 255.255.255.0 :SYST:COMM:LAN:SMASK?
:SYSTem:COMMunicate:RS232:BAUDset / query
Sets the baud rate of the RS232 interface in Baud, or queries the current baud rate.
integer (Baud) - Returns the baud rate of the RS232 interface.
:SYST:COMM:RS232:BAUD 19200 :SYST:COMM:RS232:BAUD?
:SYSTem:COMMunicate:RS232:DATABitset / query
Sets or queries the number of data bits for the RS232 interface.
| Name | Type | Values | Description |
|---|---|---|---|
| {5|6|7|8} | discrete | 5 - 8 | Data-bit value for the RS232 interface. |
integer - The query returns 5, 6, 7, or 8.
:SYST:COMM:RS232:DATAB 8 ::SYST:COMM:RS232:DATAB?
:SYSTem:COMMunicate:RS232:FLOWCrlset / query
Enables or disables the RS232 hardware flow control. The instrument uses RTS/CTS flow control and the query returns the current status.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables hardware flow control. |
:SYSTem:COMMunicate:RS232:PARItybitset / query
Sets or queries the RS232 parity mode.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | NONE | ODD | EVEN | Parity mode to set for the RS232 interface. |
:SYSTem:COMMunicate:RS232:STOPBitset / query
Sets the RS232 stop bit. The query returns the current stop bit.
| Name | Type | Values | Description |
|---|---|---|---|
| stop bit | enum | 1 | 2 | Stop bit setting. |
enum - The current stop bit value.
:SYST:COMM:RS232:STOPB 2 :SYST:COMM:RS232:STOPB?
:SYSTem:CONTrastset / query
Sets the contrast of the screen and queries the current contrast. The setter accepts a value from 1 to 100, or the MINimum/MAXimum keywords; the query returns an integer contrast value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 1 - 100 | Contrast value to set. |
| qualifieropt | enum | MINimum | MAXimum | Optional keyword to set the contrast to the minimum or maximum allowed value. |
integer - Returns the current screen contrast as an integer.
:SYST:CONT 50 :SYST:CONT?
:SYSTem:ERRor?query
Queries and clears the error messages in the error queue. The query returns the number and content of the error message.
string - The number and content of the error message, for example, -113,"Undefined header; keyword cannot be found".
:SYSTem:KLOCkset / query
Locks or unlocks the specified front-panel key. The query checks whether the specified key is locked and returns 1 or 0.
| Name | Type | Values | Description |
|---|---|---|---|
| key | discrete | DISPLAY | STORAGE | UTILITY | HELP | TIMER | ADVANCE | PRESET | CH1 | CH2 | CH3 | RANGE1 | RANGE2 | M1 | M2 | M3 | M4 | M5 | NUM0 | NUM1 | NUM2 | NUM3 | NUM4 | NUM5 | NUM6 | NUM7 | NUM8 | NUM9 | DOT | LEFT | RIGHT | UP | DOWN | OUTPUT1 | OUTPUT2 | OUTPUT3 | OUTPUTALL | KNOB | OK | BACK | DIAL | ALL | Specifies which key is locked or unlocked. |
| state | enum | ON | OFF | 1 | 0 | Locks the specified key when ON or 1, and unlocks it when OFF or 0. |
enum - Returns 1 if the specified key is locked, or 0 if it is unlocked.
:SYST:KLOC CH1,ON :SYST:KLOC? CH1
:SYSTem:KLOCk:STATeset / query
Enable or disable the remote lock. The query returns the current remote lock status.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables the remote lock. |
enum - Returns the remote lock status.
:SYST:KLOC:STAT ON :SYST:KLOC:STAT?
:SYSTem:LANGuage:TYPEset / query
Set the system language, or query the current system language type.
| Name | Type | Values | Description |
|---|---|---|---|
| language | enum | EN | CH | JAP | KOR | GER | POR | POL | CHT | RUS | Selects the system language type. |
enum - Returns the current system language as English, Chinese, Japanese, Korean, German, Portuguese, Polish, Chinese(T), or Russian.
:SYST:LANG:TYPE EN :SYST:LANG:TYPE?
:SYSTem:LOCalset / query
Returns the power supply from remote mode to local mode. When sent in remote mode, front panel operations become available again and the remote-mode status indicator disappears.
:SYSTem:LOCKset / query
Lock or unlock the front panel. The query checks whether the front panel is locked.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Locks or unlocks the front panel. |
enum - Returns the front panel lock state.
:SYST:LOCK ON :SYST:LOCK?
:SYSTem:ONOFFSyncset / query
Turns the on/off sync function on or off. The query returns whether the on/off sync function is turned on.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Sets the on/off sync function state. |
enum - Returns the on/off sync function status.
:SYST:ONOFFS ON :SYST:ONOFFS?
:SYSTem:OTPset / query
Enable or disable the over-temperature protection (OTP) function. The query returns the OTP status.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Turns the OTP function on or off. |
:SYST:OTP ON :SYST:OTP?
:SYSTem:POWEronset / query
Selects the instrument configuration to be used at power-on. The query returns the configured power-on setting.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | DEFault | LAST | Selects whether to use factory default values or the system configuration before the last power-off at power-on. |
enum - Returns DEFAULT or LAST, indicating the configuration used at power-on.
:SYST:POWE LAST :SYST:POWE?
:SYSTem:REMoteset / query
Return the power supply from local mode to remote mode.
:SYSTem: REMote
:SYSTem:RGBBrightnessset / query
Sets the RGB brightness of the screen, or queries the current RGB brightness. The setter accepts a brightness value or the keywords MINimum/MAXimum; the query can optionally take MINimum or MAXimum.
| Name | Type | Values | Description |
|---|---|---|---|
| RGBbrightness | integer | 1 - 100 | RGB brightness setting. |
| qualifieropt | enum | MINimum | MAXimum | Optional keyword to set or query the minimum or maximum brightness. |
integer - Returns the current RGB brightness of the screen.
:SYST:RGBB 47 :SYST:RGBB?
:SYSTem:RWLockset / query
Turns the remote lock on or off. When omitted, the command turns the remote lock on.
| Name | Type | Values | Description |
|---|---|---|---|
| stateopt | enum | ON | OFF | Controls whether remote lock is enabled or disabled. |
:SYST:RWL ON
:SYSTem:SAVerset / query
Enables or disables the screen saver function, or queries its current status.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables the screen saver function. |
enum - The query returns the screen saver status.
::SYST:SAV ON ::SYST:SAV?
Queries the self-test results of the TopBoard or BottomBoard. If the optional board selector is omitted, it returns the results for both boards at the same time.
| Name | Type | Values | Description |
|---|---|---|---|
| boardopt | enum | TOP | BOTTOM | Selects whether to query the TopBoard or BottomBoard self-test result. |
enum - Returns PASS or FAIL; if the board selector is omitted, returns the TopBoard and BottomBoard results separated by a comma, for example PASS,PASS.
:SYST:SELF:TEST:BOARD?
Queries the self-test result of the fan. The query returns PASS or FAIL.
enum - PASS if the fan self-test passed, or FAIL if it failed.
Query the self-test result of the temperature. The query returns the temperature value in ℃.
real (℃) - Returns the temperature value in ℃, for example, 23.67.
:SYSTem:TRACKModeset / query
Sets the track mode or queries the current track mode. The specified channels support track function, with synchronous or independent behavior between the two channels.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | SYNC | INDE | Track mode to set. |
enum - Returns the current track mode.
:SYST:TRACKM SYNC /*Set the track mode to synchronous*/ :SYST:TRACKM? /*Query the current track mode and the query returns SYNC*/
:SYSTem:VERSion?query
Queries the SCPI version number of the system.
string - The SCPI version number of the system in YYYY.V form, where YYYY is the year and V is the edition number.
:SYST:VERS? /*Query the SCPI version number of the system and the query returns 1999.0*/
:TIMEr:CYCLEsset / query
Sets the number of timer cycles, either infinite or a specified count. The query returns the current setting as `I` or `N,<value>`.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | N | I | Selects infinite cycles (`I`) or a specified number of cycles (`N`). |
| valueopt | integer | 1 - 99999 | Number of cycles when `N` is selected. |
string - Returns `I` or `N,<value>` indicating the current number of timer cycles.
:TIME:CYCLE N,20 :TIME:CYCLE?
:TIMEr:ENDStateset / query
Sets or queries the timer end state. The end state determines what the instrument does after finishing outputting the total number of groups when the number of cycles is finite.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | OFF | LAST | End state of the timer. |
enum - Returns the current end state of the timer.
:TIME:ENDS LAST :TIME:ENDS?
:TIMEr:GROUPsset / query
Set the number of output groups of the timer, or query the current number of output groups. The number of groups is defined as the number of preset voltage/current groups output in each cycle.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 1 - 2048 | Number of output groups of the timer. |
integer - Returns the current number of output groups of the timer.
:TIME:GROUP 25 :TIME:GROUP?
:TIMEr:PARAmeterset / query
Sets the timer parameters of the specified group, or queries timer parameters for one or more consecutive groups. The query returns a string data block starting with # and containing the requested groups in number,voltage,current,time format separated by semicolons.
| Name | Type | Values | Description |
|---|---|---|---|
| secnum | integer | 0 - 2047 | Group number of the specified timer-parameter group. |
| volt | real | V | Voltage of the specified group; the manual says this is the voltage range of the current channel. |
| curr | real | A | Current of the specified group; the manual says this is the current range of the current channel. |
| time | real | 1s - 99999s | Time setting for the specified group. |
string - A string starting with # containing the requested timer parameters. Each group is formatted as number,voltage,current,time and multiple groups are separated by semicolons.
:TIME:PARA 1,8,1,10 /*Set the timer parameters of the first group to 8V, 1A, 10s*/ :TIME:PARA 2,6,1,10 /*Set the timer parameters of the second group to 6V, 1A, 10s*/ :TIME:PARA? 1,2 /*Query two groups of timer parameters starting from the first group and the query returns #90000000361,8.000,1.0000,10;2,6.000,1.0000,10;*/
:TIMEr[:STATe]set / query
Enable or disable the timing output function. The query returns the current timing output status.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables the timing output function. |
enum - Returns the status of the timing output function.
:TIME ON /*Enable the timing output*/ :TIME? /*Query the status of the timing output and the query returns ON*/
:TIMEr:TEMPlet:CONSTructset / query
Creates timer parameters according to the currently selected template and the parameters already set.
:TIMEr:TEMPlet:FALLRateset / query
Sets or queries the fall index of ExpFall. The setting affects the range of timer parameters created when the ExpFall templet is selected.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 10 | Fall index of ExpFall. |
integer - The query returns the current fall index as an integer from 0 to 10.
:TIME:TEMP:FALLR 5 :TIME:TEMP:FALLR? /*Query the fall index of ExpFall and the query returns 5*/
:TIMEr:TEMPlet:INTErvalset / query
Set the time interval. Query the current time interval.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 1s - 99999s | Time required for the instrument to output each group of timer parameters created using the currently selected templet. |
integer (s) - The query returns the current time interval.
:TIME:TEMP:INTE 15 :TIME:TEMP:INTE?
:TIMEr:TEMPlet:INVErtset / query
Enables or disables the invert function of the currently selected templet. The query reports whether the invert function is enabled.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Enables or disables the invert function. |
enum - The query returns whether the invert function is enabled.
:TIME:TEMP:INVE ON :TIME:TEMP:INVE?
:TIMEr:TEMPlet:MAXValueset / query
Sets the maximum voltage or current of the currently selected templet. The query returns that maximum value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | Maximum voltage or current of the currently selected templet. |
| qualifieropt | enum | MINimum | MAXimum | Optional keyword that sets the command to the minimum or maximum allowed value. |
real - The maximum voltage or current of the currently selected templet.
:TIME:TEMP:MAXV 5 /*Set the maximum voltage of the templet currently selected to 5V*/ :TIME:TEMP:MAXV? /*Query the maximum voltage of the templet currently selected and the query returns 5.000*/
:TIMEr:TEMPlet:MINValueset / query
Sets or queries the minimum voltage or current of the currently selected templet. When the editing object is voltage, it sets the minimum voltage; when the editing object is current, it sets the minimum current.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | Voltage or current range of the channel currently selected. |
| qualifieropt | enum | MINimum | MAXimum | Allows using the minimum or maximum keyword instead of a numeric value. |
real - Returns the minimum voltage or current of the currently selected templet, for example 0.100 or 0.1000.
:TIME:TEMP:OBJ C,1.5 /*Set the current editing object to current and set the voltage to 1.5V*/ :TIME:TEMP:MINV 0.1 /*Set the minimum current of the templet currently selected to 0.1A*/ :TIME:TEMP:MINV? /*Query the minimum current of the templet currently selected and the query returns 0.1000*/
:TIMEr:TEMPlet:OBJectset / query
Selects the editing object of the templet and sets the corresponding current or voltage value. The query returns the currently selected editing object and its corresponding current or voltage, separated by a comma.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | V | C | Selects voltage or current as the editing object. |
| value | real | - | Sets the current or voltage value for the selected editing object. |
string - Returns the editing object currently selected and the corresponding voltage or current value, separated by a comma (for example, V,2.0000).
:TIME:TEMP:OBJ V,2 :TIME:TEMP:OBJ?
:TIMEr:TEMPlet:PERIodset / query
Sets or queries the period of the Pulse template. The actual allowed value depends on the currently set positive pulse width and can range from positive pulse width + 1 s to 99999 s.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 2s - 99999s | Period of the Pulse template. |
integer - The query returns the period of Pulse as an integer from 2 to 99999.
:TIME:TEMP:PERI 15 :TIME:TEMP:PERI?
:TIMEr:TEMPlet:POINTsset / query
Sets or queries the total number of points in the currently selected timer template. The Pulse template does not support this parameter.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 10 - 2048 | Total number of points. |
integer - The query returns the total number of points.
:TIME:TEMP:POINT 50 :TIME:TEMP:POINT? /*Query the total number of points and the query returns 50*/
:TIMEr:TEMPlet:RISERateset / query
Sets or queries the rise index of ExpRise. When the currently selected templet is ExpRise, this value affects the range of timer parameters that can be created.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 10 | Rise index of ExpRise. |
integer - Returns the current rise index of ExpRise.
:TIME:TEMP:RISER 5 :TIME:TEMP:RISER? /*Query the rise index of ExpRise and the query returns 5*/
:TIMEr:TEMPlet:SELectset / query
Select the desired templet type. Query the templet type currently selected.
| Name | Type | Values | Description |
|---|---|---|---|
| templet type | enum | SINE | SQUARE | RAMP | UP | DN | UPDN | RISE | FALL | Desired templet type. |
enum - The query returns the currently selected templet type.
:TIME:TEMP:SEL UP :TIME:TEMP:SEL?
:TIMEr:TEMPlet:SYMMetryset / query
Sets or queries the symmetry of RAMP. Symmetry is 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 in percent. |
integer - The query returns the symmetry value as an integer from 0 to 100.
:TIME:TEMP:SYMM 60 :TIME:TEMP:SYMM?
:TIMEr:TEMPlet:WIDThset / query
Sets the positive pulse width of Pulse, or queries the pulse width. The actual valid range depends on the period currently set by :TIMEr:TEMPlet:PERIod; it is from 1 s to (period - 1 s).
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 1s - 99998s | Positive pulse width of Pulse. |
integer - The query returns the pulse width as an integer.
:TIME:TEMP:WIDT 14 :TIME:TEMP:WIDT?
:TRIGger:IN:CHTYpeset / query
Selects the trigger source type for the input trigger system. The query returns the currently selected source type.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | BUS | IMM | Trigger source type. |
enum - Returns the trigger source type currently selected.
:TRIG:IN:CHTY BUS :TRIG:IN:CHTY?
:TRIGger:IN:CURRentset / query
Sets the trigger current of the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| channel | enum | CH1 | CH2 | CH3 | Specifies which channel's trigger current to set. |
| current | real | 0 - the maximum current of the specified channel | Sets the trigger current value. |
:TRIG:IN:CURR CH1,1 /*Set the trigger current of CH1 to 1A*/
:TRIGger:IN[:ENABle]set / query
Enables or disables the trigger input function for the specified data line. The query returns the enable status of the specified data line.
| Name | Type | Values | Description |
|---|---|---|---|
| data lineopt | discrete | D0 | D1 | D2 | D3 | Specifies the data line to control; if omitted, the currently selected data line is used. |
| state | boolean | ON | OFF | Enables or disables the trigger input function. |
enum - Returns Dn,ON or Dn,OFF for the specified data line, where n = 0, 1, 2, or 3.
:TRIG:IN D1,ON :TRIG:IN? D1
:TRIGger:IN:IMMEdiateset / query
Initializes the trigger system. If the trigger source is set to IMM, the power supply executes a complete trigger operation immediately; if set to BUS, the system is initialized and then triggered later by *TRG.
:TRIGger:IN:RESPonseset / query
Sets or queries the output response of the trigger input for the specified data line. If the data-line selector is omitted, the setter uses the currently selected data line.
| Name | Type | Values | Description |
|---|---|---|---|
| data lineopt | discrete | D0 | D1 | D2 | D3 | Specifies which data line the command applies to. |
| response | discrete | ON | OFF | ALTER | Sets the output response mode when the trigger input condition is met. |
enum - Returns the current output response of the trigger input for the specified data line.
:TRIG:IN:RESP D1,ON /*Set the output response of the trigger input of D1 to output on*/ :TRIG:IN:RESP? D1 /*Query the output response of the trigger input of D1 and the query returns ON*/
:TRIGger:IN:SENSitivityset / query
Sets or queries the trigger sensitivity of the trigger input for the specified data line. If the data line is omitted, the currently selected data line is used.
| Name | Type | Values | Description |
|---|---|---|---|
| data lineopt | enum | D0 | D1 | D2 | D3 | Specifies which data line's trigger input is affected. |
| sensitivity | enum | LOW | MID | HIGH | Selects the trigger sensitivity level. |
enum - Returns the current trigger sensitivity of the specified data line.
:TRIG:IN:SENS D1,HIGH /*Set the trigger sensitivity of the trigger input of D1 to :TRIG:IN:SENS? D1 /*Query the trigger sensitivity of the trigger input of D1
:TRIGger:IN:SOURceset / query
Sets the source controlled by the trigger input of the specified data line. The query returns the name of the selected source; multiple channels are returned as a comma-separated list.
| Name | Type | Values | Description |
|---|---|---|---|
| D0|D1|D2|D3opt | discrete | D0 | D1 | D2 | D3 | Selects the data line whose trigger input source is being set or queried. |
| CH1[,CH2[,CH3]]opt | string | - | One or more source channels to be controlled by the trigger input; CH1 is selected if omitted. |
string - Returns the name of the source under control. If multiple channels are selected, they are returned comma-separated (for example, CH1 or CH1,CH2).
:TRIG:IN:SOUR D1,CH1,CH2 /*Set the source under control of the trigger input of D1 to CH1 and CH2*/ :TRIG:IN:SOUR? D1 /*Query the source under control of the trigger input of D1 and the query returns CH1,CH2*/
:TRIGger:IN:TYPEset / query
Sets the trigger type of the trigger input for the specified data line, or queries the current trigger type. If the line is omitted, the currently selected data line is used.
| Name | Type | Values | Description |
|---|---|---|---|
| data lineopt | enum | D0 | D1 | D2 | D3 | Specifies which data line's trigger input is affected. |
| type | enum | RISE | FALL | HIGH | LOW | Selects the trigger condition: rising edge, falling edge, high level, or low level. |
enum - Returns the trigger type of the specified data line as RISE, FALL, HIGH, or LOW.
:TRIG:IN:TYPE D1,FALL /*Set the trigger type of the trigger input of D1 to the :TRIG:IN:TYPE? D1 /*Query the trigger type of the trigger input of D1 and the query returns FALL*/
:TRIGger:IN:VOLTageset / query
Sets the trigger voltage of the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| channel | discrete | CH1 | CH2 | CH3 | Specifies which channel's trigger voltage to set. |
| voltage | real | 0 - the maximum voltage of the specified channel | Sets the trigger voltage for the selected channel. |
:TRIG:IN:VOLT CH1,1 /*Set the trigger voltage of CH1 to 1V*/
:TRIGger:OUT:CONDitionset / query
Sets or queries the trigger condition of the trigger output for a specified data line. When a voltage, current, or power trigger is selected, an associated value is used; otherwise the trigger condition is OUTOFF, OUTON, or AUTO.
| Name | Type | Values | Description |
|---|---|---|---|
| [D0|D1|D2|D3]opt | discrete | D0 | D1 | D2 | D3 | Specifies the data line whose trigger output condition is being set or queried. |
| mode | enum | OUTOFF | OUTON | >V | <V | =V | >C | <C | =C | >P | <P | =P | AUTO | Selects the trigger condition type. |
| valueopt | real | - | Voltage, current, or power threshold used when a threshold-based trigger condition is selected. |
enum - Returns the current trigger condition of the specified data line. If the condition is OUTOFF, OUTON, or AUTO, those keywords are returned; if a threshold-based condition is set, the query returns the condition and the corresponding value, for example, >V,8.800.
:TRIG:OUT:COND D1,>V,8.8 :TRIG:OUT:COND? D1
:TRIGger:OUT:DUTYset / query
Sets or queries the duty cycle of the square waveform of the trigger output on the specified data line. If the data line is omitted, the current selected data line is used.
| Name | Type | Values | Description |
|---|---|---|---|
| data lineopt | enum | D0 | D1 | D2 | D3 | Selects the trigger output data line. |
| value | integer | 10 - 90 | Sets the duty cycle percentage. |
integer - Returns the duty cycle of the square waveform of the trigger output on the specified data line.
:TRIG:OUT:DUTY D1,60 /*Set the duty cycle of the square waveform of the trigger output on D1 to 60%*/ :TRIG:OUT:DUTY? D1 /*Query the duty cycle of the square waveform of the trigger output on D1 and the query returns 60*/
:TRIGger:OUT[:ENABle]set / query
Enables or disables the trigger output function of the specified data line. The query returns the current data line and ON/OFF status.
| Name | Type | Values | Description |
|---|---|---|---|
| data lineopt | discrete | D0 | D1 | D2 | D3 | Specifies the data line to control; if omitted, the currently selected data line is used. |
| state | boolean | ON | OFF | Enables or disables the trigger output function. |
enum - Returns the specified data line and its trigger output status as Dn,ON or Dn,OFF, where n is 0, 1, 2, or 3.
:TRIGger:OUT:PERIodset / query
Sets or queries the period of the square waveform of the trigger output on the specified data line. If the data line is omitted, the currently selected data line is used.
| Name | Type | Values | Description |
|---|---|---|---|
| data lineopt | enum | D0 | D1 | D2 | D3 | Selects the data line for the trigger output period. |
| value | real | 0.000100s - 2.500000s | Sets the period of the trigger output square waveform. |
real - Returns the period of the square waveform of the trigger output on the specified data line.
:TRIG:OUT:PERI D1,0.005 /*Set the period of the square waveform of the trigger output on D1 to 5ms*/ :TRIG:OUT:PERI? D1 /*Query the period of the square waveform of the trigger output on D1 and the query returns 0.005000*/
:TRIGger:OUT:POLArityset / query
Sets or queries the polarity of the trigger output signal for the specified data line. If the data line is omitted, the currently selected data line is used.
| Name | Type | Values | Description |
|---|---|---|---|
| data lineopt | enum | D0 | D1 | D2 | D3 | Specifies which data line to use. |
| polarity | enum | POSItive | NEGAtive | Sets the trigger output polarity. |
:TRIG:OUT:POLA D1,NEGAtive /* Set the polarity of the trigger output signal of :TRIG:OUT:POLA? D1 /* Query the polarity of the trigger output signal of
:TRIGger:OUT:SIGNalset / query
Sets or queries the type of the trigger output signal for the specified data line. LEVEL outputs a level signal and SQUARE outputs a square waveform when the trigger condition is met.
| Name | Type | Values | Description |
|---|---|---|---|
| data lineopt | enum | D0 | D1 | D2 | D3 | Specifies which data line is affected; if omitted, the currently selected data line is used. |
| mode | enum | LEVEL | SQUARE | Selects the trigger output signal type. |
:TRIG:OUT:SIGN D1,LEVEL :TRIG:OUT:SIGN? D1
:TRIGger:OUT:SOURceset / query
Sets or queries the control source of the trigger output for the specified data line. If the data line is omitted, the currently selected data line is used.
| Name | Type | Values | Description |
|---|---|---|---|
| data lineopt | discrete | D0 | D1 | D2 | D3 | Specifies which data line to use. |
| source | enum | CH1 | CH2 | CH3 | Selects the control source for trigger output. |
:TRIG:OUT:SOUR D1,CH1 /*Set the control source of D1 to CH1*/ :TRIG:OUT:SOUR? D1 /*Query the control source of D1 and the query returns CH1*/
:TRIGger[:SEQuence]:DELayset / query
Sets the trigger delay, or queries the current trigger delay. The trigger delay is only valid when the trigger source is BUS.
| Name | Type | Values | Description |
|---|---|---|---|
| seconds | integer | 0 - 3600 | Trigger delay time. |
integer (s) - The current trigger delay in seconds.
:TRIG:DEL 3 :TRIG:DEL? /*Query the current trigger delay and the query returns 3*/
:TRIGger[:SEQuence]:SOURceset / query
Selects the trigger source for the sequence trigger system. The query returns the currently selected trigger source.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | BUS | IMM | Trigger source to select. |
enum - Returns the current trigger source.
:TRIG:SOUR BUS :TRIG:SOUR?