:ABORtset / query
Stops any operation that is triggered.
SCPI COMMAND REFERENCE
The Rigol DG821PRO is Rigol's function generator in the DG800 Pro/DG900 Pro Series family. Its SCPI remote-control interface exposes 113 commands across 12 subsystems - 92 settable and 21 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.
113
Commands
92
Settable
21
Queries
12
Subsystems
SCPI
1994.0
Verified
2026-07-16
All commands
113 of 113 commands
Queries the statistical results for counter measurements.
string - Returns six comma-separated parts representing the current value, maximum value, minimum value, average value, standard deviation, and statistical count. When the counter statistical function is disabled, the query returns 0,0,0,0,0,0.
:COUNter:AVERage:ALL? /*Queries the statistical results for counter measurements. The query might return +1.000004E+06,+1.000005E+06,+1.000003E+06,+1.000004E+06,+0.000000E+00,35.*/
:COUNter:AVERage:CLEarset / query
Clears the statistical results for counter measurements.
:COUNter:AVERage:CLEar /*Clears the statistical results for counter measurements.*/
:COUNter:AVERage[:STATe]set / query
Sets or queries the on/off status of the statistical function for the frequency counter.
| Name | Type | Values | Description |
|---|---|---|---|
| state | boolean | 0 | 1 | OFF | ON | Enables or disables the statistical function. |
enum - The query returns 0 or 1.
:COUNter:COUPlingset / query
Sets or queries the coupling type of input signals for counter measurements.
| Name | Type | Values | Description |
|---|---|---|---|
| coupling | enum | AC | DC | Selects the coupling type for counter measurements. |
enum - The query returns the current coupling type.
:COUNter:COUPling DC :COUNter:COUPling?
:COUNter[:FREQuency]:RANGeset / query
Sets or queries the frequency range for counter measurements.
| Name | Type | Values | Description |
|---|---|---|---|
| range | - | - |
:COUNter:GATetimeset / query
Sets or queries the gate time for counter measurements. When used to specify the gate time, the auto gate function is automatically disabled.
| Name | Type | Values | Description |
|---|---|---|---|
| time | real | 1 ms - 10,000 s | Gate time for counter measurements. |
| lim | enum | MINimum | MAXimum | Selects the minimum or maximum gate time. |
returns
:COUNter:GATetime:AUTO[:STATe]set / query
Sets or queries the on/off status of the auto gate function for counter measurements. When enabled, the instrument selects an appropriate gate time automatically according to the signal characteristics.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | enum | 0 | 1 | OFF | ON | Enables or disables the auto gate function. |
enum - Returns 0 or 1.
::COUNter:GATetime:AUTO:STATe ON ::COUNter:GATetime:AUTO:STATe?
:COUNter:HFset / query
Sets or queries the on/off status of the HF Suppression function for counter measurements.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | enum | 0 | 1 | OFF | ON | Enables or disables HF suppression. |
enum - The query returns 0 or 1.
:COUNter:IMPedanceset / query
Sets or queries the input impedance for the frequency counter.
| Name | Type | Values | Description |
|---|---|---|---|
| impedance | enum | OMEG | FIFTy | Input impedance setting for the frequency counter. |
enum - The query returns FIFT or OMEG.
:COUNter:MEASure?query
Queries the measurement results for the frequency counter.
string - A comma-separated string of five scientific-notation values representing frequency, period, duty cycle, positive pulse width, and negative pulse width. When the counter function is disabled, the query returns 0,0,0,0,0.
:COUNter:MEASure? /*Queries the measurement results for the frequency counter. The query might return +1.000000000000000E +03,+1.0000000000000001E-03,+5.760000000000000E +01,+5.760000000000000E-04,+4.240000000000000E-04.*/
:COUNter:RUN:STATeset / query
Sets or queries the counter run state.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | - |
:COUNter:SINGleset / query
Sets the frequency counter to single-measurement mode. The instrument executes one measurement and then enters the Stop state; this command is available only when the counter is enabled.
:COUNter[:STATe]set / query
Sets or queries the on/off status of the frequency counter.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | enum | 0 | 1 | OFF | ON | Enables or disables the frequency counter. |
enum - The query returns 0 or 1.
:COUNter:STATe ON /*Enables the frequency counter.*/ :COUNter:STATe? /*Queries the on/off status of the frequency counter. The query returns 1.*/
:DISPlay:BRIGhtnessset / query
Sets or queries the display brightness. The query can optionally take a limit qualifier.
| Name | Type | Values | Description |
|---|---|---|---|
| brightness | real | - | |
| lim | enum | lim |
:DISPlay:COUNterset / query
Sets or queries the currently displayed measurement parameter for counter measurements.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | FREQuency | PERiod | DUTY | PWIDth | NWIDth | Selects the counter measurement parameter to display. |
enum - Returns the currently displayed counter measurement parameter as a short keyword.
:DISPlay:FOCusset / query
Sets or queries the current channel.
| Name | Type | Values | Description |
|---|---|---|---|
| chan | enum | CH1 | CH2 | Selects the current channel. |
enum - The query returns the current channel as CH1 or CH2.
:DISPlay:FOCus CH1 /*Sets the current channel to CH1.*/ :DISPlay:FOCus? /*Queries the current channel. The query returns CH1.*/
:DISPlay[:STATe]set / query
Enables or disables the front-panel screen. Queries the current state of the front-panel screen.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | boolean | - | Boolean state to set the front-panel screen on or off. |
boolean - The current state of the front-panel screen.
:DISPlay:TEXTset / query
Sets or queries the text message displayed on the front-panel screen. When a text message is displayed, the instrument enters notifier mode until the front-panel key is pressed or the text is cleared with :DISPlay:TEXT:CLEar.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | ASCII text message to display, enclosed by double quotation marks, up to 40 characters. |
string - Returns the current display text as a character string, for example, "Test in progress".
:DISPlay:TEXT "Test in progress" :DISPlay:TEXT?
:DISPlay:TEXT:CLEarset / query
Clears the text message displayed on the front-panel screen.
:DISPlay:TEXT:CLEar /*Clears the text message displayed on the front-panel screen.*/
:DISPlay:UNIT:PULSeset / query
Sets or queries the method used to specify pulse width. WIDTh specifies pulse width in seconds, and DUTY specifies pulse width in percentage.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | WIDTh | DUTY | Method used to specify the pulse width. |
enum - Returns the current method used to specify the pulse width.
:DISPlay:UNIT:RATEset / query
Sets or queries the rate unit for Sine, Square, Ramp, Pulse, Arb, and Harmonic.
| Name | Type | Values | Description |
|---|---|---|---|
| unit | enum | FREQuency | PERiod | Selects the rate unit. |
enum - Returns the current rate unit.
:DISPlay:UNIT:RATE PERiod /*Sets the rate unit to s for Sine, Square, Ramp, Pulse, Arb, and Harmonic.*/ :DISPlay:UNIT:RATE? /*Queries the rate unit for Sine, Square, Ramp, Pulse, Arb, and Harmonic. The query returns PER.*/
:DISPlay:UNIT:SWEepset / query
Sets or queries the method to specify the frequency sweep range.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | - | Method used to specify the frequency sweep range. |
:DISPlay:UNIT:VOLTageset / query
Sets or queries the method to specify the voltage range.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | AMPLitudeoff | HIGHlow | Selects whether the voltage range is specified by amplitude/offset or by high/low level. |
enum - Returns the current voltage-range specification method.
:DISPlay:UNIT:VOLTage AMPLitudeoff :DISPlay:UNIT:VOLTage?
:HCOPy:SDUMp:DATA?query
Captures the current screen.
block - The query returns the data stream of the screen image.
:HCOPy:SDUMp:DATA:FORMatset / query
Sets or queries the format of the screen image.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | BMP | PNG | Screen image format. |
enum - The query returns BMP or PNG.
:HCOPy:SDUMp:DATA:FORMat PNG /*Sets the format of the image to PNG.*/ :HCOPy:SDUMp:DATA:FORMat? /*Queries the format of the screen image. The query returns PNG.*/
*CLSset / query
Clears all the event registers, and also clears the error queue.
*ESEset / query
Sets or queries the enable register of the standard event register set.
| Name | Type | Values | Description |
|---|---|---|---|
| maskargument | integer | 0 - 255 | Bit mask for the standard event register enable register. |
integer - Returns the current enable register value of the standard event register set.
*ESR?query
Queries and clears the event register of the standard event status register.
integer - The query returns an integer equal to the binary-weighted sum of all bits set in the register. Bits 1 and 6 are always 0, so the returned value corresponds to a binary number X0XXXX0X.
*IDN?query
Queries the ID string of the instrument.
*OPCset / query
Sets the OPC (bit 0, "Operation Complete") of the Standard Event register to 1 after all commands are executed. The query checks whether all previous commands have executed and returns 1 after the command is executed.
integer - Returns 1 to the output buffer after the command is executed.
*OPT?query
Queries the options installed in the instrument.
enum - Returns the installed options separated by commas. If an option is installed, the query returns the option name; if no option is installed, it returns NONE.
*OPT? /*Queries the options installed. The query returns NONE.*/
*PSCset / query
Enables or disables clearing the enable registers of the Status Byte and Standard Event registers at power-on. The query reports the on/off state of that function.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | boolean | - | Enables or disables clearing the enable registers of the Status Byte and Standard Event registers at power-on. |
*RCLset / query
Recalls a previously stored instrument state from the specified non-volatile memory location.
| Name | Type | Values | Description |
|---|---|---|---|
| value | discrete | 0 - 5 | Memory location containing the stored instrument state to recall. |
*RCL 1 /*Recalls the instrument state stored in memory location 1.*/
*RSTset / query
Resets the instrument to its factory default state.
*SAVset / query
Stores the current instrument state to a specified location in non-volatile memory. If a file already exists in the specified location, the command overwrites it directly without a prompt.
| Name | Type | Values | Description |
|---|---|---|---|
| value | discrete | 0 | 1 | 2 | 3 | 4 | 5 | Specified storage location in non-volatile memory. |
*SAV 1 /*Stores the current instrument state to memory location 1.*/
*SREset / query
Sets or queries the enable register of the status byte register set.
| Name | Type | Values | Description |
|---|---|---|---|
| maskargument | integer | 0 - 255 | Sets the enable register value as the sum of the decimal values of all bits set in the status byte register. |
integer - The decimal-weighted sum of all bits set in the status byte register.
*SRE 16 *SRE?
*STB?query
Queries the event register for the status byte register. After executing the command, the value in the status byte register is cleared.
integer - Returns the status byte register value as an integer.
*TRGset / query
Generates a trigger event.
*TRG /*Generates a trigger event.*/
*TST?query
Executes the self-test and returns the results.
integer - Returns the self-test result as an integer.
*WAIset / query
Waits for the operation to complete so that the previous command finishes before the next command is issued.
:INITiate[<n>]:CONTinuousset / query
Sets or queries whether the trigger system always returns to the "wait-for-trigger" state for the specified channel. When set to ON, the trigger count setting becomes invalid; when omitted, <n> is interpreted as CH1.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | discrete | 1 | 2 | Channel number to apply the setting to. |
| bool | boolean | 0 | 1 | OFF | ON | Enables or disables returning to the "wait-for-trigger" state. |
enum - Returns the present setting as 0 or 1.
:INITiate1:CONTinuous ON /*Sets CH1 to automatically return to "wait-for-trigger".*/ :INITiate1:CONTinuous? /*Queries whether CH1 automatically returns to "wait-for-trigger". The query returns 1.*/
:INITiate[<n>]:CONTinuous:ALLset / query
Sets or queries whether the trigger system always returns to the "wait-for-trigger" state for both channels.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | enum | 0 | 1 | OFF | ON | Enables or disables always returning to the "wait-for-trigger" state. |
:INITiate[<n>][:IMMediate]set / query
Changes the trigger system status from "idle" to "wait-for-trigger" for the specified channel.
:INITiate[<n>][:IMMediate]:ALLset / query
Changes the status of the trigger system from "idle" to "wait-for-trigger" for both channels.
:LXI:MDNS:STATeset / query
Sets or queries the on/off status of the multicast Domain Name System (mDNS).
| Name | Type | Values | Description |
|---|---|---|---|
| bool | enum | 0 | 1 | OFF | ON | Enables or disables mDNS. |
enum - The query returns 0 or 1.
:LXI:MDNS:STATe ON /*Enables the mDNS.*/ :LXI:MDNS:STATe? /*Queries whether the mDNS is enabled. The query returns 1.*/
:LXI:MDNS:SNAMe:DESiredset / query
Sets or queries the service name for mDNS.
| Name | Type | Values | Description |
|---|---|---|---|
| name | string | - | Specifies the mDNS service name, which can contain English characters and numbers; total length no more than 99 characters. |
:LXI:RESetset / query
Sets the network settings to default values. It may take a few seconds for the LAN interface to restart after you send this command.
:LXI:RESet /*Sets the network settings to default values.*/
:LXI:RESTartset / query
Restarts the LAN interface.
:MEMory:NSTates?query
Queries the number of memory locations for storing states.
integer - The query returns 6.
:MEMory:NSTates? /*Queries the number of memory locations for the state files in the non-volatile memory of the instrument. The query returns 6.*/
Queries the names of the state files in the internal non-volatile memory of the instrument.
string - Returns the names of the state files in the internal non-volatile memory of the instrument.
:MEMory:STATe:DELeteset / query
Deletes the state file stored in the specified memory location.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 0 | 1 | 2 | 3 | 4 | 5 | Specifies the memory location whose state file is deleted. |
:MEMory:STATe:DELete 1 /*Deletes the state file stored in location 1.*/
:MEMory:STATe:NAMEset / query
Sets or queries the filename of the state file stored in the instrument's internal non-volatile memory. The state file location is specified by <n> and an optional name may be assigned; if omitted, the factory default name is used.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 0 | 1 | 2 | 3 | 4 | 5 | Specifies one of the six internal memory locations for the state file. |
| nameopt | string | - | Sets the filename stored for the selected state file location. |
string - Returns the filename of the selected state file as a quoted string.
:MEMory:STATe:NAME 2,state :MEMory:STATe:NAME? 2
:MEMory:STATe:RECall:AUTOset / query
Sets or queries whether state files are recalled automatically.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | boolean | - | Enables or disables automatic state-file recall. |
:MEMory:STATe:VALid?query
Queries whether a state file is available in the specified memory location in the instrument's internal non-volatile memory.
| Name | Type | Values | Description |
|---|---|---|---|
| state | discrete | 0 - 5 | Memory location to check. |
enum - Returns whether a state file is available in the specified memory location.
Queries all the files in the specified directory.
| Name | Type | Values | Description |
|---|---|---|---|
| folderopt | string | - | Directory to catalog. |
string - Returns the files in the specified directory.
Queries all arbitrary waveform files (*.arb/*.barb/*.csv) and sequence files (*.seq) in the specified directory. If <folder> is omitted, the command queries the directory specified by :MMEMory:CDIRectory.
| Name | Type | Values | Description |
|---|---|---|---|
| <folder>opt | string | - | Valid directory in internal or external memory. |
string - Returns a comma-separated listing of space used, space available, and file entries in the target directory.
Queries the state file (*.sta) under the specified directory. If the folder is omitted, the current directory is queried.
| Name | Type | Values | Description |
|---|---|---|---|
| <folder>opt | string | - | Valid directory in the internal or external memory. |
string - Returns a string in the format of space used, space available, and zero or more quoted file entries; file property is STAT and file size is the amount of space the file uses.
:MMEMory:CDIRectoryset / query
Sets or queries the default directory for :MMEMory commands. The directory must be a valid directory in internal or external memory.
| Name | Type | Values | Description |
|---|---|---|---|
| directory_name | string | - | The directory path to use as the default directory. |
string - Returns the current default directory as a string.
:MMEMory:CDIRectory INT:/folder /*Sets the default directory to INT:/folder (the "folder" in internal memory).*/ :MMEMory:CDIRectory? /*Queries the default directory. The query returns INT:/folder.*/
:MMEMory:COPYset / query
Copies a file to the specified directory, not the current directory.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | |
| directory_name | string | - |
:MMEMory:COPY:SEQuenceset / query
Copies a specified sequence file (.seq) to the specified directory.
| Name | Type | Values | Description |
|---|---|---|---|
| sequence | string | - | Filename of the sequence to be copied; the filename must include the file extension. |
| directoryname | string | - | Target directory path. |
:MMEMory:DELeteset / query
Deletes a specific file under the specified directory.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | Valid filename. |
:MMEMory:DELete INT:\screenshot.png /*Deletes the image named screenshot.png under C disk.*/
:MMEMory:LOAD:DATAset / query
Loads a sequence file (*.seq) or arbitrary waveform file (*.arb) from internal or external memory into the volatile memory of the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | - | Specified channel number. |
| file_name | string | - | File name of the sequence or arbitrary waveform file to load. |
:MMEMory:LOAD:STATeset / query
Loads the specified state file.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | Name of the state file under the specified directory. |
:MMEMory:LOAD:STATe INT:\Mystate.sta /*Loads the instrument state file named Mystate.sta from the root directory of the internal memory.*/
:MMEMory:MDIRectoryset / query
:MMEMory:MOVEset / query
Moves file 1 under the current directory to the specified directory, or renames file 1 to file 2.
| Name | Type | Values | Description |
|---|---|---|---|
| file1 | string | - | File 1 to move or rename. |
| file2 | string | - | Target directory or filename. |
:MMEMory:RDIRectoryset / query
Deletes the specified empty directory in the mass memory system. An error is displayed if the folder is not empty.
| Name | Type | Values | Description |
|---|---|---|---|
| folder | string | - | Folder name of the empty folder. |
:MMEMory:RDIRectory folder /*Deletes the empty folder named "folder" in the internal mass memory.*/
:MMEMory:STORe:DATAset / query
Stores a sequence file (*.seq) in volatile memory of the specified channel to the specified directory.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 2 | Specified channel number. |
| file_name | string | - | Directory and file name to store the sequence file. |
:MMEMory:STORe:DATA 1,INT:\Seq_1.seq /*Stores a sequence file (*.seq) in volatile memory of CH1 to the internal memory with the name of Seq_1.seq.*/
:MMEMory:STORe:STATeset / query
Stores the current instrument state with the specified name in the specified directory.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | File name or directory path where the instrument state is stored. |
:OUTPut[<n>]:IDLEset / query
Sets or queries the idle level position of the burst mode for the specified channel. When [<n>] is omitted, it is interpreted as CH1.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | discrete | 1 | 2 | Specifies the channel number. |
| idle | integer | 0 - 65535 | Self-defines the idle level position. |
| position | enum | FPT | TOP | CENTer | BOTTom | Selects the idle level position as first point, top, center, or bottom of the waveform. |
enum - The query returns FPT, TOP, CENT, or BOTT; or returns the idle level position in an integer.
:OUTPut1:IDLE TOP /*Sets the idle level to the top point of the waveform.*/
:OUTPut[<n>]:LOADset / query
Sets or queries the output impedance for the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | discrete | 1 | 2 | Specifies the output channel number; when omitted, it is interpreted as CH1. |
| ohms | integer | 1 - 10 kΩ | Sets the output impedance to a specified value. |
| lim_set | discrete | INFinity | MINimum | MAXimum | DEFault | Sets the impedance to HighZ, the minimum value, the maximum value, or the default value. |
real (Ω) - Returns the output impedance in scientific notation; returns 9.9E+37 when the output connector impedance is set to HighZ (INFinity).
:OUTPut1:LOAD INFinity /*Sets the output impedance to HighZ for CH1 output connector.*/
:OUTPut[<n>]:POLarityset / query
Sets or queries the output polarity for the specified channel. When [<n>] is omitted, it is interpreted as CH1.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | discrete | 1 | 2 | Specifies the output channel number. |
| polarity | enum | NORMal | INVerted | Sets the output connector polarity to normal or inverted. |
enum - Returns the current output polarity.
:OUTPut1:POLarity NORMal /*Sets the CH1 output polarity to Normal.*/ :OUTPut1:POLarity? /*Queries the CH1 output polarity. The query returns NORM.*/
:OUTPut[<n>][:STATe]set / query
Sets or queries the output state for the specified channel. When [<n>] is omitted, it is interpreted as CH1.
| Name | Type | Values | Description |
|---|---|---|---|
| <n>opt | discrete | 1 | 2 | Specifies the output channel. |
| <state> | enum | - | Sets the output state. |
enum - The query returns the output state.
:OUTPut[<n>]:SYNCset / query
Sets or queries the output state of the sync signal. The sync signal is associated with Sine, Square, Ramp, Pulse, Arb (except DC), Sweep, burst, and modulated waveforms.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | discrete | 1 | 2 | Specifies the channel; if omitted, it is interpreted as CH1. |
| state | boolean | 0 | 1 | OFF | ON | Enables or disables the sync output. |
enum - The query returns 0 or 1.
:OUTPut[<n>]:SYNC:MODEset / query
Sets or queries whether the frequency mark function is enabled for the specified channel. When <n> is omitted, it is interpreted as CH1.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | discrete | 1 | 2 | Output channel number. |
| mode | enum | NORMal | MARKer | Enables or disables the frequency mark function. |
enum - Returns the current frequency mark state.
:OUTPut1:SYNC:MODE MARKer /*Enables the frequency mark function for CH1.*/
:OUTPut[<n>]:SYNC:POLarityset / query
Sets or queries the polarity of the sync signal for the specified channel. When [<n>] is omitted, it is interpreted as CH1.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | discrete | 1 | 2 | Channel number for the sync signal output. |
| polarity | enum | NORMal | INVerted | Sets the sync signal output polarity to rising edge or falling edge. |
enum - The query returns the sync signal output polarity as NORM or INV.
:OUTPut1:SYNC:POLarity NORMal /*Sets the output polarity of CH1 sync signal to rising edge.*/ :OUTPut1:SYNC:POLarity? /*Queries the output polarity of CH1 sync signal. The query returns NORM.*/
:OUTPut[<n>]:SYNC:SOURceset / query
Sets or queries the sync signal output port for the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| <n>opt | discrete | 1 | 2 | Specifies the output channel number; when omitted, CH1 is assumed. |
| <port> | - | - | Sync signal output port. |
:OUTPut[<n>]:TRIGgerset / query
Sets or queries whether the trigger output is enabled for Sweep or Burst mode.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | discrete | 1 | 2 | |
| bool | boolean | 0 | 1 | OFF | ON |
:OUTPut[<n>]:TRIGger:SLOPeset / query
Sets or queries the edge of the trigger output signal for the specified channel. POSitive outputs a leading-edge pulse and NEGative outputs a trailing-edge pulse.
| Name | Type | Values | Description |
|---|---|---|---|
| <n>opt | discrete | 1 | 2 | Specified channel number; when omitted, it is interpreted as CH1. |
| <type> | enum | POSitive | NEGative | Selects the trigger output edge. |
:OUTPut1:TRIGger:SLOPe NEGative /*Sets the edge of the trigger output signal to trailing edge for CH1.*/ :OUTPut1:TRIGger:SLOPe? /*Queries the edge of the trigger output signal for CH1. The query returns NEG.*/
:SYSTem:BEEPer[:IMMediate]set / query
Issues a single beep immediately.
:SYSTem:BEEPer:IMMediate /*Issues a single beep immediately.*/
:SYSTem:BEEPer:STATeset / query
Sets or queries the on/off status of the beeper.
| Name | Type | Values | Description |
|---|---|---|---|
| state | boolean | 1 | ON | 0 | OFF | On/off state of the beeper. |
:SYSTem:BEEPer:IMMediate /*Issues a single beep immediately.*/
:SYSTem:DATEset / query
Sets or queries the system date.
| Name | Type | Values | Description |
|---|---|---|---|
| yyyy | integer | 1970 - 2037 | |
| mm | integer | 01 - 12 | |
| dd | integer | 01 - 31 (28, 29, or 30) |
string - The query returns the system date in character string. The year, month, and day are separated by "-".
:SYSTem:DATE 2022,05,01 /*Sets the system date to May 1, 2022.*/ :SYSTem:DATE? /*Queries the system date. The query returns 2022-05-01.*/
:SYSTem:COMMunicateset / query
:SYSTem:COMMunicate:LAN:DHCP[:STATe]set / query
Sets or queries the on/off status of DHCP mode. In DHCP mode, the instrument automatically assigns an IP address from a DHCP server.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | enum | 0 | 1 | OFF | ON | On/off state of DHCP mode. |
enum - Returns the current DHCP mode state as an on/off value.
:SYSTem:COMMunicate:LAN:DNSset / query
Sets or queries the domain name server (DNS) address.
| Name | Type | Values | Description |
|---|---|---|---|
| dns | string | - | DNS address in the form nnn.nnn.nnn.nnn. |
string - The query returns the DNS address, for example, 172.16.3.2.
:SYSTem:COMMunicate:LAN:DNS 172.16.3.2 :SYSTem:COMMunicate:LAN:DNS?
Queries the domain name.
string - The query returns a string.
:SYSTem:COMMunicate:LAN:DOMain? /*Queries the domain name. The query returns YYYrigollan.*/
:SYSTem:COMMunicate:LAN:GATewayset / query
Sets or queries the default gateway.
| Name | Type | Values | Description |
|---|---|---|---|
| gateway | string | - | Default gateway address in nnn.nnn.nnn.nnn format; the first octet ranges from 1 to 223 excluding 127, and the other three octets range from 0 to 255. |
:SYSTem:COMMunicate:LAN:HOSTnameset / query
Sets or queries the hostname.
| Name | Type | Values | Description |
|---|---|---|---|
| <name> | string | - | The specified hostname, up to 15 characters; it must start with a letter and may contain letters, numbers, and hyphens. |
string - The query returns a string.
:SYSTem:COMMunicate:LAN:HOSTname RIGOL123 /*Sets the hostname to RIGOL123.*/ :SYSTem:COMMunicate:LAN:HOSTname? /*Queries the hostname. The query returns RIGOL123.*/
:SYSTem:COMMunicate:LAN:IPADdressset / query
Sets or queries the LAN IP address. After sending this command, execute :SYSTem:COMMunicate:LAN:UPDate to apply the current network setting for the new parameters to take effect.
| Name | Type | Values | Description |
|---|---|---|---|
| <ip> | string | - | IP address to set for the LAN interface. |
string - The query returns the current IP address as a string, for example 172.16.3.1.
Queries the MAC address.
string - The query returns the MAC address, usually expressed in hexadecimal format such as 00:2A:A0:AA:E0:56.
:SYSTem:COMMunicate:LAN:SMASkset / query
Sets or queries the subnet mask. After changing it, execute :SYSTem:COMMunicate:LAN:UPDate to apply the new network settings.
| Name | Type | Values | Description |
|---|---|---|---|
| <submask> | string | 0 - 255 | Subnet mask in nnn.nnn.nnn.nnn format, with each nnn from 0 to 255. |
string - Returns the current subnet mask, such as 255.255.255.0.
:SYSTem:COMMunicate:LAN:SMASk 255.255.255.0 /*Sets the subnet mask to 255.255.255.0.*/ :SYSTem:COMMunicate:LAN:SMASk? /*Queries the current subnet mask. The query returns 255.255.255.0.*/
:SYSTem:COMMunicate:LAN:UPDateset / query
Applies the current network settings so new LAN parameters take effect.
Queries the instrument's USB information.
string - Returns the instrument's USB information, for example USB0::0x1AB1::0x052::DG80000000001::INSTR.
:SYSTem:COMMunicate:USB:INFormation? /*Queries the instrument's USB information. The query returns USB0::0x1AB1::0x052::DG80000000001::INSTR.*/
:SYSTem:ERRor?query
Queries and clears an error message in the error queue.
string - Returns a string with two comma-separated parts: the error number and the error message content in double quotation marks. Reading the error queue clears the error.
:SYSTem:ERRor? /*Queries and clears an error message in the error queue. The query returns -109,"Missing parameter".*/
:SYSTem:KLOCkset / query
Sets or queries the status of all front-panel keys. The keys can be locked to avoid misoperation.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | enum | 1 | ON | 0 | OFF | Locks or unlocks all front-panel keys. |
:SYSTem:LANGuageset / query
Sets or queries the system language.
| Name | Type | Values | Description |
|---|---|---|---|
| language | enum | SCHinese | ENGLish | Selects the system language. |
enum - Returns the current system language as SCH or ENGL.
:SYSTem:LANGuage ENGLish /*Sets the system language to English.*/ :SYSTem:LANGuage? /*Queries the system language. The query returns ENGL.*/
Queries the options currently activated.
:SYSTem:LICense:DELeteset / query
Deletes the installed option.
| Name | Type | Values | Description |
|---|---|---|---|
| name | enum | CHD | MEM | Option name to delete. |
:SYSTem:LICense:DELete MEM /*Deletes the installed memory depth upgrade option.*/
:SYSTem:LICense:DELete:ALLset / query
Deletes all the installed options.
:SYSTem:LICense:DELete:ALL /*Deletes all the installed options.*/
:SYSTem:LICense:INSTallset / query
Installs the option using a license string.
| Name | Type | Values | Description |
|---|---|---|---|
| license | string | - | License string used to install the option. |
:SYSTem:LICense:INSTall "<license>"
:SYSTem:LICense:INSTall:UDISkset / query
Installs the option using a license file.
| Name | Type | Values | Description |
|---|---|---|---|
| <path> | string | Valid directory | Path to the license file; it must include the .lic file extension. |
:SYSTem:PSTatusset / query
Sets or queries the power status of the instrument.
| Name | Type | Values | Description |
|---|---|---|---|
| power | enum | DEFault | OPEN | Power status to set. |
enum - The query returns DEF or OPEN.
:SYSTem:PSTatus DEFault /*Sets the power status to DEFault.*/ :SYSTem:PSTatus? /*Queries the power status of the instrument. The query returns DEF.*/
:SYSTem:TIMEset / query
Sets or queries the system time.
| Name | Type | Values | Description |
|---|---|---|---|
| hour | integer | 0 - 23 | |
| minute | integer | 0 - 59 | |
| second | integer | 0 - 59 |
returns
:SYSTem:TOUChset / query
Sets or queries whether the touch screen is enabled.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | boolean | - | Enables or disables the touch screen. |
enum - Returns 0 or 1.
:SYSTem:TIME 16,10,17 /*Sets the system time to 16:10:17.*/ :SYSTem:TIME? /*Queries the system time. The query returns 16:10:17.*/
:SYSTem:VERSion?query
Queries the version number of the SCPI used by the system.
string - The SCPI version string in the form of "YYYY.V", where "YYYY" is the year of the version and "V" is the version for that year (e.g. 1994.0).
:SYSTem:VERSion? /*Queries the version number of the SCPI used by the system. It might return 1994.0.*/
:SYSTem:ROSCillator:SOURceset / query
Sets or queries the system clock source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | INTernal | EXTernal | System clock source. |
enum - Returns the current system clock source.
:TRIGger<n>:COUNtset / query
Sets or queries the trigger count for the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | Specified channel number. |
| count | integer | 1 - 1000000 | Trigger count value. |
| lim_set | discrete | MINimum | MAXimum | DEFault | Set count to the minimum, maximum, or default value. |
| lim_queryopt | discrete | MINimum | MAXimum | Returns the minimum or maximum trigger count. |
:TRIGger<n>:DELayset / query
Sets or queries the trigger delay for the specified channel. Trigger delay is only available for N-Cycle burst mode, and the valid delay range depends on the burst trigger source.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | Channel number. |
| seconds | real | 0 s - 20 s | Trigger delay in seconds. |
| qualifieropt | enum | MINimum | MAXimum | DEFault | Use a keyword instead of a numeric delay value. |
:TRIGger<n>[:IMMediate]set / query
Generates a trigger event in the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | Specifies the channel number. |
:TRIGger1:IMMediate /*Generates a trigger event in CH1.*/
:TRIGger<n>:SLOPeset / query
Sets or queries the edge type of the external trigger signal for the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 2 | |
| slope | enum | POSitive | NEGative | Selects the trigger edge polarity. |
enum - Returns the trigger slope as POS or NEG.
:TRIGger1:SLOPe NEGative /*Sets the edge type of the trigger input signal to trailing edge for CH1.*/ :TRIGger1:SLOPe? /*Queries the edge type of the trigger input signal for CH1. The query returns NEG.*/
:TRIGger<n>:SOURceset / query
Sets or queries the trigger type for the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| <n> | integer | 1 - 2 | Specifies the channel number. |
| source | enum | INTernal | EXTernal | Selects the trigger source. |
:TRIGger<n>:TIMerset / query
Sets or queries the trigger timer for the specified channel. The query returns the trigger timer in scientific notation.
| Name | Type | Values | Description |
|---|---|---|---|
| <n> | discrete | - | Channel number. |
| <timer> | real | 1 μs - 8000 s | Trigger timer value. |
| qualifieropt | enum | MINimum | MAXimum | Returns the minimum or maximum trigger timer value. |
real - The trigger timer value, returned in scientific notation (for example, 1.000000E+00 indicates 1 s).
:TRIGger1:TIMer 1 /*Sets the trigger timer to 1 s for CH1.*/ :TRIGger1:TIMer? /*Queries the trigger timer for CH1. The query returns 1.000000E+00.*/