/

Rigol

/

Rigol DG1032Z

SCPI COMMAND REFERENCE

Rigol DG1032Z

Rigol DG1032Z

The Rigol DG1032Z is Rigol's function generator in the DG1000Z Series family. Its SCPI remote-control interface exposes 130 commands across 14 subsystems - 107 settable and 23 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.

130

Commands

107

Settable

23

Queries

14

Subsystems

SCPI

Verified

2026-07-16

All commands

:COUNter:AUTOset / query

The instrument automatically selects a proper gate time according to the characteristics of the signal under test. It is related to :COUNter:GATEtime.

Sets the coupling mode of the counter input signal to AC or DC. The query returns the current coupling mode.

NameTypeValuesDescription
modeenumAC | DCCoupling mode for the input signal.
enum - Returns the current coupling mode.
:COUN:COUP DC
:COUN:COUP?

Selects the gate time of the measurement system. The available values are USER1 through USER6; the query returns the currently selected gate time or AUTO while automatic selection is in progress.

NameTypeValuesDescription
gate timeenumUSER1 | USER2 | USER3 | USER4 | USER5 | USER6Selects the gate time setting.
enum - Returns the currently selected gate time: USER1, USER2, USER3, USER4, USER5, USER6, or AUTO while the instrument is automatically selecting a gate time.
:COUN:GATE USER2
:COUN:GATE?
:COUNter:HFset / query

Enable or disable the high-frequency rejection function of the frequency counter. The query returns the on/off status of that function.

NameTypeValuesDescription
stateenumON | 1 | OFF | 0Enables or disables high-frequency rejection.
enum - Returns ON or OFF.
:COUN:HF ON
:COUN:HF?
:COUNter:LEVElset / query

Sets or queries the trigger level of the frequency counter. The query returns the trigger level in scientific notation with 7 effective digits.

NameTypeValuesDescription
valuereal-2.5V - 2.5VTrigger level used when the frequency counter starts measuring as the input signal reaches this level.
qualifieroptenumMINimum | MAXimumOptional keyword qualifier for the setter or query syntax.
real (V) - Returns the trigger level of the frequency counter in scientific notation.
:COUN:LEVE 1.5
:COUN:LEVE?

Queries the measurement results of the frequency counter. When the counter is RUN, SINGLE, or STOP, it returns the current or last measurement values; when disabled, it returns zeros.

string - Returns a comma-separated string of five scientific-notation values: frequency, period, duty cycle, positive pulse width, and negative pulse width. When the frequency counter function is disabled, all five values are zero.
:COUN:MEAS? /*Query the measurement results of the frequency counter and the query returns 2.000000000E+03,5.000000000E-04, 4.760800000E+01,2.380415000E-04,2.619585000E-04*/

Sets or queries the trigger sensitivity of the frequency counter.

NameTypeValuesDescription
valuereal0% - 100%Trigger sensitivity to set for the frequency counter.
qualifieroptenumMINimum | MAXimumOptional query qualifier that returns the minimum or maximum trigger sensitivity.
real (%) - Returns the trigger sensitivity of the frequency counter in scientific notation.
:COUN:SENS 30
:COUN:SENS?
:COUNter[:STATe]set / query

Sets or queries the status of the frequency counter. The enabled state uses ON/OFF (or 1/0), and when enabled the running status can be RUN, STOP, or SINGLE.

NameTypeValuesDescription
stateenumON | 1 | OFF | 0 | RUN | STOP | SINGLESets the frequency counter function and, when enabled, its running status.
enum - Returns the current running status of the frequency counter; when enabled this is RUN, STOP, or SINGLE, and when disabled it returns OFF.
:COUN OFF
:COUN?
:COUN 1
:COUN?
:COUN STOP
:COUN?

Clear the statistic results. This command is only valid when the frequency counter statistic function is enabled; results are cleared automatically when the function is disabled.

Sets the display format of the statistic results of the frequency counter measurement values to DIGITAL or CURVE. The query returns the current display format.

NameTypeValuesDescription
modeenumDIGITAL | CURVEDisplay format for the statistic results.
enum - Returns the current display format of the statistic results.
:COUN:STATI:DISP CURVE
:COUN:STATI:DISP?

Enable or disable the statistic function of the measurement values of the frequency counter. The query reports the on/off status of the statistic function.

NameTypeValuesDescription
stateoptenumON | 1 | OFF | 0Enables or disables the statistic function.
enum - Returns the on/off status of the statistic function.
:COUN:STATI ON
:COUN:STATI?

Sets or queries the amplitude deviation in the amplitude coupling. The query returns the amplitude deviation in scientific notation with 7 effective digits.

NameTypeValuesDescription
deviationreal-19.998Vpp - 19.998VppAmplitude deviation to set in the amplitude coupling.
string - The query returns the amplitude deviation in scientific notation with 7 effective digits.
:COUP:AMPL:DEV 1
:COUP:AMPL:DEV?

Sets the amplitude coupling mode to amplitude deviation (OFFSet) or amplitude ratio (RATio). The query returns the selected amplitude coupling mode.

NameTypeValuesDescription
modeenumOFFSet | RATioAmplitude coupling mode.
enum - Returns the selected amplitude coupling mode.
:COUP:AMPL:MODE OFFS
:COUP:AMPL:MODE?

Sets the amplitude ratio in the amplitude coupling, or queries the current amplitude ratio. When queried, the command returns the ratio in scientific notation with 7 effective digits.

NameTypeValuesDescription
valuereal0.001 - 1000Amplitude ratio to set.
qualifieroptenumMINimum | MAXimumOptional keyword to set the minimum or maximum amplitude ratio.
real - Amplitude ratio in scientific notation with 7 effective digits.
:COUP:AMPL:RAT 1.123
:COUP:AMPL:RAT?

Enables or disables the amplitude coupling function. The query returns the on/off status of amplitude coupling.

NameTypeValuesDescription
stateenumON | 1 | OFF | 0Sets the amplitude coupling function on or off.
enum - Returns the on/off status of the amplitude coupling function.
:COUP:AMPL ON
:COUP:AMPL?

Sets the frequency deviation in the frequency coupling, or queries the current frequency deviation. The query returns the deviation in scientific notation with 7 effective digits.

NameTypeValuesDescription
deviationreal-59.999 999 999 999MHz - 59.999 999 999 999MHzFrequency deviation to set in the frequency coupling.
real - The query returns the frequency deviation in scientific notation with 7 effective digits.
:COUP:FREQ:DEV 100
:COUP:FREQ:DEV?

Sets the frequency coupling mode to frequency deviation (OFFSet) or frequency ratio (RATio). The query returns the selected frequency coupling mode.

NameTypeValuesDescription
modeenumOFFSet | RATioSelects the frequency coupling mode.
enum - Returns the selected frequency coupling mode as OFFSET or RATIO.
:COUP:FREQ:MODE OFFS
:COUP:FREQ:MODE?

Sets or queries the frequency ratio in the frequency coupling.

NameTypeValuesDescription
valuereal0.000 001 - 1 000 000Frequency ratio value.
real - Returns the frequency ratio in scientific notation with 7 effective digits.
:COUP:FREQ:RAT 100.123
:COUP:FREQ:RAT?

Enables or disables the frequency coupling function. The query returns the on/off status of the frequency coupling function.

NameTypeValuesDescription
stateenumON | 1 | OFF | 0Turns frequency coupling on or off.
enum - Returns the on/off status of the frequency coupling function.
:COUP:FREQ ON /*Enable the frequency coupling function*/
:COUP:FREQ? /*Query the on/off status of the frequency coupling function and
the query returns ON*/

Sets or queries the phase deviation used in phase coupling. The deviation must be between -360° and 360°.

NameTypeValuesDescription
deviationreal-360° - 360°Phase deviation value.
real - The query returns the phase deviation in scientific notation with 7 effective digits.
:COUP:PHAS:DEV 90
:COUP:PHAS:DEV?

Sets the phase coupling mode to phase deviation (OFFSet) or phase ratio (RATio). The query returns the selected phase coupling mode.

NameTypeValuesDescription
modeenumOFFSet | RATioSelects the phase coupling mode.
enum - Returns the selected phase coupling mode as OFFSET or RATIO.
:COUP:PHAS:MODE OFFS /*Set the phase coupling mode to phase deviation*/
:COUP:PHAS:MODE? /*Query the phase coupling mode and the query returns OFFSET*/

Sets or queries the phase ratio in the phase coupling. The query returns the phase ratio in scientific notation with 7 effective digits.

NameTypeValuesDescription
valuereal0.01 - 100Phase ratio to set.
real - The phase ratio in scientific notation, with 7 effective digits.
:COUP:PHAS:RAT 1.12 /*Set the phase ratio in the phase coupling to 1.12*/
:COUP:PHAS:RAT? /*Query the phase ratio in the phase coupling and the query returns 1.120000E+00*/

Enables or disables the phase coupling function. The query returns the on/off status of phase coupling.

NameTypeValuesDescription
statebooleanON | 1 | OFF | 0Turns phase coupling on or off.
enum - Returns ON or OFF.
:COUP:PHAS ON /*Enable the phase coupling function*/
:COUP:PHAS? /*Query the on/off status of the phase coupling function and the query returns ON*/

Enables or disables frequency coupling, phase coupling, and amplitude coupling of the channel at the same time. The query returns the on/off states of the three coupling functions in order, separated by commas.

NameTypeValuesDescription
stateenumON | 1 | OFF | 0Turns coupling on or off.
string - Returns a comma-separated string with the on/off states of frequency coupling, phase coupling, and amplitude coupling in order, for example FREQ:ON,PHASE:OFF,AMPL:OFF.
:COUP ON
:COUP?

Sets or queries the screen brightness. The query returns the screen brightness in scientific notation with 7 effective digits.

NameTypeValuesDescription
brightnessinteger1% - 100%Screen brightness level.
qualifieroptenumMINimum | MAXimumOptional query qualifier to request the minimum or maximum brightness value.
string - The screen brightness in scientific notation with 7 effective digits.
:DISP:BRIG 51
:DISP:BRIG?

Sets the screen contrast or queries the current screen contrast. The query returns the contrast in scientific notation with 7 effective digits.

NameTypeValuesDescription
contrastinteger1% - 100%Screen contrast setting.
qualifieroptenumMINimum | MAXimumUses the minimum or maximum contrast value.
real - The current screen contrast in scientific notation with 7 effective digits.
:DISP:CONT 28
:DISP:CONT?

Queries the front-panel screen image (screenshot). The returned data is a definite-length binary block containing the image.

definite_length_block - A definite-length binary data block containing the screenshot image. The block starts with #.
:DISPlay:DATA?
:DISPlay:MODEset / query

Sets the display mode to dual-channel parameters, dual-channel graph, or single-channel display mode. The query returns the current display mode.

NameTypeValuesDescription
modeenumDPV | DGV | SVDisplay mode to select.
enum - Returns the current display mode.
:DISP:MODE DGV
:DISP:MODE?

Enable or disable the screen saver function. The query returns the on/off status of the screen saver function.

NameTypeValuesDescription
stateoptenumON | 1 | OFF | 0Enables or disables the screen saver function.
enum - Returns the on/off status of the screen saver function.
:DISP:SAV OFF
:DISP:SAV?
:DISP:SAV 1
:DISP:SAV?
:DISPlay[:STATe]set / query

Enable or disable the screen display. The display is automatically enabled when the instrument returns to local mode.

NameTypeValuesDescription
stateenumON | 1 | OFF | 0Enables or disables the screen display.
:DISP OFF
:DISP?
:DISP 1
:DISP?

Query the string currently displayed on the screen. The query returns the current screen text enclosed in double quotation marks.

string - The string currently displayed on the screen, returned in double quotation marks.
:DISP:TEXT?

Displays the specified quoted string at the specified screen coordinates. If only one coordinate is supplied, it is treated as the horizontal x value; omitted coordinates use the last effective coordinate or the default coordinate after power-on.

NameTypeValuesDescription
quoted stringstring-String enclosed in double quotation marks to display on the screen, up to 45 characters.
xoptinteger2 - 319Horizontal coordinate of the upper-left corner of the displayed string.
yoptinteger2 - 239Vertical coordinate of the upper-left corner of the displayed string.
:DISP:TEXT "RIGON",25,35

Queries the image displayed on the front panel screen (screenshot). The query returns a definite-length binary data block containing the image.

definite_length_block - A definite-length binary data block containing the screenshot image. The block starts with #.

Sets or queries the format of the image returned by the screenshot operation. The manual slice documents only the BMP format.

NameTypeValuesDescription
formatenumBMPImage format for the screenshot operation.
:HCOP:SDUM:DATA:FORM BMP
:HCOP:SDUM:DATA:FORM?

*CLSset / query

Clears the event registers of all register sets and the error queue.

*ESEset / query

Enables bits to be reported to the status byte register in the standard event register. The query returns the enabled bits as a decimal value.

NameTypeValuesDescription
valueinteger-Decimal value corresponding to the sum of the binary weights of the bits to be reported to the status byte register in the standard event register.
*ESR?query

Queries the event register of the standard event register. The event register is read-only and is cleared when queried.

integer - Returns a decimal value corresponding to the sum of the binary weights of all bits in the event register of the standard event register.
*IDN?query

Queries the ID string of the instrument.

string - The instrument ID string, consisting of four comma-separated parts: manufacturer name, instrument model, instrument serial number, and digital board version number.
*OPCset / query

Sets the OPC (operation complete) bit in the standard event register after all previously sent commands have executed. The query checks whether all previously sent commands have executed and returns 1 if so.

integer - Returns 1 if all previously sent commands have executed; otherwise 0.
*OPC
*OPC?
*OPT?query

Queries whether the 16M internal memory option (Arb 16M) has been installed.

enum - Returns OFFICAL if the 16M internal memory option has been installed, or UNINSTALL if it is not installed.
*OPT?
*PSCset / query

Enables or disables clearing the status byte enable register and standard event enable register at power-on. The query reports the current power-on status clear setting.

NameTypeValuesDescription
{0|1}enum0 | 1Selects whether the status byte enable register and standard event enable register are cleared at power-on.
enum - Returns the current status clear setting at power-on.
*PSC 1
*PSC?
*RCLset / query

Recalls the state file (USER) or arbitrary waveform file (ARB) stored in the specified location in internal non-volatile memory.

NameTypeValuesDescription
locationenumUSER1 | USER2 | USER3 | USER4 | USER5 | USER6 | USER7 | USER8 | USER9 | USER10 | ARB1 | ARB2 | ARB3 | ARB4 | ARB5 | ARB6 | ARB7 | ARB8 | ARB9 | ARB10Specifies the storage location to recall.
*RSTset / query

Restores the instrument to its factory state. It stops any sweep or burst in progress abnormally and turns the display on if it was previously turned off.

*SAVset / query

Stores the current instrument state (USER) or arbitrary waveform data (ARB) in the specified internal non-volatile memory location with the default name.

NameTypeValuesDescription
storage locationenumUSER1 | USER2 | USER3 | USER4 | USER5 | USER6 | USER7 | USER8 | USER9 | USER10 | ARB1 | ARB2 | ARB3 | ARB4 | ARB5 | ARB6 | ARB7 | ARB8 | ARB9 | ARB10Selects the storage location for the state or arbitrary waveform file.
*SAV USER1
*SREset / query

Enables bits in the status byte register to generate a service request. The query returns the decimal value corresponding to the sum of the binary weights of the bits enabled in the status byte register.

NameTypeValuesDescription
valueinteger-Decimal value corresponding to the sum of the binary weights of the bits enabled in the status byte register.
integer - Decimal value corresponding to the sum of the binary weights of the bits enabled in the status byte register.
*STB?query

Queries the status register of the status byte register. This command cannot clear the service request; bit6 remains set while the service-request condition is still in effect.

integer - Returns a decimal value corresponding to the sum of the binary weights of all the bits in the status register of the status byte register.
*TRGset / query

Triggers a sweep or burst. It can only be used over the remote interface when sweep or burst is enabled and the trigger source is set to manual.

*WAIset / query

Execute any other command via the interface after all pending operations are completed. It is only applicable to triggered sweep mode or triggered burst mode and is used to ensure synchronization.

:LICense:INSTallset / query

Install the 16M internal memory option (Arb 16M).

NameTypeValuesDescription
snstring-Option serial number string, 28 bytes long, containing uppercase English letters and numbers.

Turns the LXI Identify indicator on the screen on or off. The query returns the current on/off status of the indicator.

NameTypeValuesDescription
stateenumON | 1 | OFF | 0Sets the LXI Identify indicator state.
enum - Returns the on/off status of the LXI Identify indicator.
:LXI:IDEN ON
:LXI:IDEN?
:LXI:MDNS:ENABleset / query

Enable or disable the multiple DNS system (mDNS). The query returns the current mDNS status.

NameTypeValuesDescription
stateenumON | 1 | OFF | 0Enables or disables the multiple DNS system.
enum - Returns the mDNS status as ON or OFF.
:LXI:MDNS:ENAB ON /*Enable the multiple DNS system*/
:LXI:MDNS:ENAB? /*Query the status of the multiple DNS system and the
query returns ON*/
:LXI:MDNS:HNAMeset / query

Queries the host name of the analyzed mDNS service.

string - The query returns the host name as a string.

Sets the mDNS service name, or queries the current mDNS service name. The name is stored in non-volatile memory and is reset to its default by :SYSTem:SECurity:IMMediate.

NameTypeValuesDescription
namestring-Service name to assign to mDNS.
string - Returns the current mDNS service name, for example RIGOL1.
:LXI:MDNS:SNAM:DES RIGOL1 /*Set the service name of mDNS to RIGOL1*/
LXI:MDNS:SNAM:DES? /*Query the service name of mDNS and the query returns RIGOL1*/
:LXI:RESetset / query

Reset the LAN setting to the known operation state, beginning from DHCP. If DHCP fails, AutoIP is used.

:LXI:RESTartset / query

Restart the LAN according to the current setting. Several seconds are required for the LAN interface to restart after sending this command.

Queries the number of storage locations for state files in the instrument's internal non-volatile memory.

integer - Returns the number of state-file storage locations in the internal memory.

Queries the state files stored in the internal non-volatile memory of the instrument.

string - Returns a string consisting of 10 comma-separated parts, representing the filenames stored in locations 1 to 10 respectively; empty quotation marks are returned for locations with no file stored.

Deletes the state file stored in the specified internal non-volatile memory location. The command is valid only when the location contains a state file and the file is not locked.

NameTypeValuesDescription
locationenumUSER1 | USER2 | USER3 | USER4 | USER5 | USER6 | USER7 | USER8 | USER9 | USER10Specifies which of the 10 internal state file storage locations to delete.
:MEM:STAT:DEL USER1

Locks or unlocks the state file stored in the specified internal non-volatile memory storage location. The query checks whether the specified state file is locked.

NameTypeValuesDescription
locationenumUSER1 | USER2 | USER3 | USER4 | USER5 | USER6 | USER7 | USER8 | USER9 | USER10Specifies the internal state file storage location.
stateenumON | 1 | OFF | 0Sets whether the selected state file is locked or unlocked.
:MEM:STAT:LOCK USER1,ON
:MEM:STAT:LOCK? USER1

Modifies or queries the filename of the state file stored in a specified internal non-volatile memory location. The location is selected by an index from 0 to 9, representing storage locations 1 to 10.

NameTypeValuesDescription
locationdiscrete0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9Storage location index for the state file.
nameoptstring-Filename to assign to the state file; if omitted, the filename is empty.
string - Returns the filename of the state file stored in the specified location, enclosed in double quotation marks.
:MEM:STAT:NAME 1,123
:MEM:STAT:NAME? 1

Sets the instrument configuration to be used at the next power-on to the last-used settings or the factory default. The query reports which configuration will be used at the next power-on.

NameTypeValuesDescription
stateenumON | 1 | OFF | 0Selects whether the next power-on uses the last instrument configuration or the default configuration.
enum - Returns ON or OFF to indicate whether the next power-on configuration is set to last-used or default.
:MEM:STAT:RECall:AUTO ON /*Set the instrument configuration to be used at
:MEM:STAT:RECall:AUTO? /*Query the instrument configuration to be used at

Queries whether the specified storage location in internal non-volatile memory contains a state file.

NameTypeValuesDescription
locationenumUSER1 | USER2 | USER3 | USER4 | USER5 | USER6 | USER7 | USER8 | USER9 | USER10Storage location to check for a state file.
integer - Returns 1 if the specified storage location contains a state file, or 0 if it does not.

Queries all the files and folders in the current directory. This command is only applicable to external memory.

NameTypeValuesDescription
folderoptstring-Valid directory in the external memory, including the D disk and folders in the D disk.
string - Returns a comma-separated string containing space used, space available, and then file/folder records in the form "size,property,name".
:MMEM:CAT? /*Query all the files and folders in the external memory and the query returns 28672,4102361088,"3,DIR,Rigol","80,,Rigol1.RAF","1360,,Rigol 0.RSF"*/

Queries the arbitrary waveform files in the current operation directory. This command is only applicable to external memory and accepts an optional folder path.

NameTypeValuesDescription
folderoptstring-Valid directory in the external memory, enclosed in double quotation marks.
string - Returns a comma-separated string of space used, space available, and file records in the form "size,property,name".
Assume that the current directory is D:\, :MMEM:CAT:DATA:ARB? /*Query the arbitrary waveform file in the external memory directory and the query returns 28672,4102361088,"80,,Rigol1.RAF"*/

Queries the state file under the current operation directory in external memory. The query returns a string listing space used, space available, and any matching state files.

NameTypeValuesDescription
folderoptstring-Valid directory in the external memory, such as "D:\" or a folder under the D disk.
string - A string in the format space used,space available,"size,property,name",…… for files in the specified external-memory folder.
:MMEM:CAT:STAT? /*Query the state file in the external memory directory and the query returns 28672,4102361088,"1360,,Rigol0.RSF"*/

Sets the current directory in external memory, or queries the current directory. The directory must be a valid external-memory path such as "D:\" or a folder under the D disk.

NameTypeValuesDescription
directory_namestring-Current directory path in external memory.
string - The current directory as a string enclosed in double quotation marks, for example "D:\".
:MMEM:CDIR "D:\"
:MMEM:CDIR?
:MMEMory:COPYset / query

Copies a file from the current directory in external memory to a specified directory in external memory. This command is only applicable to external memory.

NameTypeValuesDescription
directory_namestring-Target directory in the external memory.
file_namestring-Filename of the file under the current directory of the external memory.
:MMEM:COPY "D:\Rigol","Rigol1.RAF"
:MMEMory:DELeteset / query

Delete the specified file or empty folder in the current directory of the external memory.

NameTypeValuesDescription
<file_name>string-The filename of the file or the folder name of the empty folder in the current directory of the external memory.
:MMEM:DEL "Rigol1.RAF" /*Delete the file Rigol1.RAF in the external memory
(D:\)*/

Load the specified state file or arbitrary waveform file in the current directory of the external memory.

NameTypeValuesDescription
<file_name>string-The filename of the state file or the arbitrary waveform file in the current directory of the external memory.
:MMEM:LOAD "Rigol0.RSF" /*Load the file Rigol0.RSF in the external memory (D:\)*/

Loads the specified arbitrary waveform file from the current directory of the external memory into the specified channel. This command applies only to external memory.

NameTypeValuesDescription
channeloptdiscrete1 - 2Selects the target channel: CH1 or CH2. If omitted, the file is loaded into CH1.
file_namestring-Filename of the arbitrary waveform file in the current directory of the external memory, enclosed in double quotation marks.
:MMEM:LOAD:DATA "Rigol4.RAF"

Load the specified state file in the current directory of the external memory.

NameTypeValuesDescription
file_namestring-The filename of the state file in the current directory of the external memory.
:MMEM:LOAD "Rigol0.RSF"

Creates a folder in the current directory of the external memory with the specified name. This command is only applicable to the external memory.

NameTypeValuesDescription
dir_namestring-Name of the folder to be created; must be enclosed in double quotation marks and cannot exceed 9 characters.
:MMEM:MDIR "RIGOL1" /*Create a folder named “RIGOL1” in D disk*/

Queries the available disk drives in external memory. The response is a string giving the number of available drives and their names, or "0,\"NULL\"" if none are available.

string - Returns the number of disk drives available and the names of the available disk drives, in a string such as "1,\"D:\""; if no disk drive is available, returns "0,\"NULL\"".

Delete the specified empty directory in the external memory.

NameTypeValuesDescription
folderstring-Folder name of the empty folder in the external memory.
:MMEM:RDIR "111" /*Delete the empty folder 111 in the external memory*/

Stores the current instrument state or the arbitrary waveform data of the current channel into external memory under the specified file name. The command is only applicable to external memory; the filename must be enclosed in double quotation marks and include the .RSF or .RAF suffix.

NameTypeValuesDescription
file_namestring-Filename of the specified state file or arbitrary waveform file.
:MMEM:STOR "R00.RSF" /*Store the current instrument state into D disk in the state file form with the filename R00.RSF*/

Stores the arbitrary waveform data of the specified channel into the current directory of the external memory as an arbitrary waveform file. It is only applicable to external memory.

NameTypeValuesDescription
channelenum1 | 2Specifies which channel's arbitrary waveform data to store.
file_namestring-Filename of the specified arbitrary waveform file.
:MMEM:STOR:DATA "R11.RAF"

Stores the current instrument state into the current directory of the external memory as a state file with the specified filename.

NameTypeValuesDescription
<file_name>string-Filename for the state file, enclosed in double quotation marks, including the .RSF suffix.
:MMEM:STOR:STAT "R22.RSF" /*Store the current instrument state into D disk in state file form with the filename R22.RSF*/

Sets or queries the gate polarity of the specified channel in gated mode. When [<n>] is omitted, CH1 is used by default.

NameTypeValuesDescription
[<n>]optdiscrete1 - 2Specifies the channel number.
polarityenumPOSitive | NEGativeSets the gate polarity to positive or negative.
enum - Returns the gate polarity of the specified channel in gated mode.
:OUTP1:GAT:POL NEG /*Set the gate polarity of CH1 in the gated mode to negative*/
:OUTP1:GAT:POL? /*Query the gate polarity of CH1 in the gated mode and the query returns NEGATIVE*/

Sets the output impedance of the specified channel's output connector. The query form returns the output impedance in scientific notation with 7 effective digits; INFinity is returned as 9.900000E+37.

NameTypeValuesDescription
<n>optdiscrete1 - 2Selects the output channel; when omitted, CH1 is used by default.
ohmsinteger1Ω - 10kΩSets the output impedance to a specified value within the allowed range.
:OUTP1:IMP INF
:OUTP1:IMP?
:OUTP1:LOAD 100
:OUTP1:LOAD?

Sets the output impedance of the output connector of the specified channel. The channel defaults to CH1 when [<n>] is omitted.

NameTypeValuesDescription
[<n>]optdiscrete1 | 2Selects the output channel.
<ohms>integer1Ω - 10kΩSets the output impedance to a specified value within the available range.
qualifieroptenumMINimum | MAXimumOptional query qualifier for :OUTPut[<n>]:LOAD?.
:OUTP1:LOAD 100
:OUTP1:LOAD?

Sets the output mode of the specified channel's output connector to normal or gated, and the query returns the current mode. When <n> is omitted, CH1 is used by default.

NameTypeValuesDescription
<n>optdiscrete1 - 2Specifies the output channel number.
modeenumNORMal | GATedSelects normal or gated output mode.
enum - Returns the current output mode of the specified channel.
:OUTP1:MODE GAT
:OUTP1:MODE?

Sets or queries the output polarity of the specified channel. Normal polarity is NORMal and inverted polarity is INVerted; when <n> is omitted, CH1 is used by default.

NameTypeValuesDescription
noptdiscrete1 - 2Specifies the channel number.
polarityenumNORMal | INVertedSets the output polarity to normal or inverted.
enum - The query returns the current output polarity.
:OUTP1:POL NORM /*Set the output polarity of CH1 to normal*/
:OUTP1:POL? /*Query the output polarity of CH1 and the query returns NORMAL*/

Turns on or off the output of the specified channel, and queries the output status of the specified channel.

NameTypeValuesDescription
[<n>]optdiscrete1 - 2Selects the output channel; when omitted, CH1 is used by default.
stateenumON | 1 | OFF | 0Sets the output state to on or off.
enum - Returns ON or OFF.
:OUTP1? /*Query the output status of CH1 and the query returns OFF*/
:OUTP1 ON /*Turn on the output of CH1*/
:OUTP1? /*Query the output status of CH1 and the query returns ON*/

Sets the output delay time of the sync signal on the rear-panel [Mod/Trig/FSK/Sync] connector for the specified channel. When the modulation, sweep, or burst function is enabled, the delay setting is invalid.

NameTypeValuesDescription
[<n>]optdiscrete1 - 2Specifies the channel number; if omitted, CH1 is used by default.
<delay>real0s - the carrier periodOutput delay time of the sync signal.
qualifieroptenumMINimum | MAXimumUse MINimum or MAXimum in place of a numeric delay value.
real - Returns the delay time of the sync signal in scientific notation with 7 effective digits.
:OUTP1:SYNC:DEL 0.001
:OUTP1:SYNC:DEL?

Sets or queries the output polarity of the sync signal on the specified channel's rear-panel [Mod/Trig/FSK/Sync] connector. Normal output is POSitive; inverted output is NEGative.

NameTypeValuesDescription
[<n>]optdiscrete1 - 2Specifies the channel number; if omitted, CH1 is used by default.
modeenumPOSitive | NEGativeSelects normal or inverted sync-signal polarity.
enum - Returns the current sync-signal polarity as POS or NEG.
:OUTP1:SYNC:POL POS
:OUTP1:SYNC:POL?

Enables or disables the sync signal output from the [Mod/Trig/FSK/Sync] connector of the specified channel at the rear panel. The query returns the current sync output status.

NameTypeValuesDescription
noptdiscrete1 - 2Specifies the channel number; when omitted, CH1 is used by default.
stateenumON | 1 | OFF | 0Enables or disables the sync signal output.
enum - Returns the sync output status.
:OUTP1:SYNC 1
:OUTP1:SYNC?
:OUTP1:SYNC OFF
:OUTP1:SYNC?

:PA:GAINset / query

Sets or queries the gain of the signal amplification at the PA output terminal. The gain can be set to 1X or 10X.

NameTypeValuesDescription
gainenum1X | 10XGain setting for the PA output amplification.
:PA:GAIN 10X
:PA:GAIN?

Turns on or off the output offset at the output terminal of the PA. The query returns the on/off status.

NameTypeValuesDescription
stateenumON | 1 | OFF | 0On/off state of the output offset at the output terminal of the PA.
enum - Returns ON or OFF.
:PA:OFFS ON /*Turn on the output offset at the output terminal of the PA*/
:PA:OFFS? /*Query the on/off status of the output offset at the output terminal of the PA and the query returns ON*/
:PA:OFFSet:VALUeset / query

Sets the output offset at the output terminal of the PA. The query form returns the output offset in scientific notation with 7 effective digits.

NameTypeValuesDescription
valuereal-12V - 12VOutput offset value to set.
qualifieroptenumMINimum | MAXimumSets or queries the minimum or maximum output offset value.

Sets the output polarity of the PA output terminal to normal or inverted. The query returns the current polarity as NORMAL or INVERTED.

NameTypeValuesDescription
modeenumNORMal | INVertedSelects normal or inverted output polarity.
enum - Returns the current output polarity.
:PA:OUTP:POL NORM /*Set the output polarity of the signal at the output
:PA:OUTP:POL? /*Query the output polarity of the signal at the output
:PA:SAVEset / query

Save the current working state of the PA into the internal memory of the instrument.

:PA[:STATe]set / query

Turn the external power amplifier on or off. The query returns the on/off status of the external power amplifier.

NameTypeValuesDescription
stateenumON | 1 | OFF | 0Turns the external power amplifier on or off.
enum - Returns the on/off status of the external power amplifier.
:PA ON
:PA?

Sets the system clock source to internal or external. When external is selected and no valid external clock is detected, the instrument switches to internal clock automatically.

NameTypeValuesDescription
sourceenumINTernal | EXTernalSelects the system clock source.
:ROSC:SOUR INT /*Set the system clock source to internal source*/

Queries the currently selected system clock source. The query returns INT or EXT.

enum - Returns the present system clock source.
:ROSC:SOUR:CURR? /*Query the system clock source currently selected and the query returns INT*/

Generate a beep immediately. This command is not affected by the current beeper on/off status.

Turn on or off the beeper.

NameTypeValuesDescription
stateenumON | 1 | OFF | 0Beeper on/off state.
":SYST:BEEP:STAT 1"
":SYST:BEEP:STAT?"

Select the current channel or query the current channel.

NameTypeValuesDescription
channelenumCH1 | CH2Channel to select as the current channel.
enum - Returns the current channel.
:SYST:CHAN:CUR CH2
:SYST:CHAN:CUR?

Query the number of channels of the instrument.

integer - The number of channels of the instrument.

Sets the GPIB address of the instrument, or queries the current GPIB address. The query returns the address in scientific notation with 7 effective digits.

NameTypeValuesDescription
integerinteger0 - 30GPIB address to assign to the instrument.
real - The GPIB address in scientific notation with 7 effective digits.
:SYST:COMM:GPIB:ADDR 7
:SYST:COMM:GPIB:ADDR?

Applies the current LAN network parameters. The new settings take effect only after this command is executed.

Turns the LAN AutoIP configuration mode on or off. The query returns the current AutoIP status.

NameTypeValuesDescription
stateoptenumON | 1 | OFF | 0Enables or disables the AutoIP configuration mode.
enum - Returns the AutoIP configuration mode status.
:SYST:COMM:LAN:AUTO OFF
:SYST:COMM:LAN:AUTO?

Query the number of the initial control connecting terminal used for socket communication.

integer - Returns 5555; if the interface does not support socket, returns 0.

Turns DHCP configuration mode on or off. The query returns the current DHCP mode status.

NameTypeValuesDescription
stateenumON | 1 | OFF | 0Sets the DHCP configuration mode.
enum - Returns ON or OFF indicating the status of DHCP configuration mode.
:SYST:COMM:LAN:DHCP OFF
:SYST:COMM:LAN:DHCP?

Sets the DNS (Domain Name Service) address, or queries the current DNS address. The command is only valid when ManualIP configuration mode is enabled, and the new setting takes effect after :SYSTem:COMMunicate:LAN:APPLy is executed.

NameTypeValuesDescription
addressstring-DNS address in nnn.nnn.nnn.nnn format, with the first octet from 1 to 223 except 127 and the other three octets from 0 to 255.
string - Returns the DNS address as a string.
:SYST:COMM:LAN:DNS 202.106.46.151
:SYST:COMM:LAN:DNS?

Set the domain name. Query the domain name.

NameTypeValuesDescription
namestring-The specified domain name; it can include English characters and numbers and cannot exceed 99 characters.
string - Returns the domain name as a string.
:SYST:COMM:LAN:DOM RIGOL
:SYST:COMM:LAN:DOM?

Sets or queries the default gateway for the LAN interface. The command is only valid when ManualIP configuration mode is turned on, and changes take effect after :SYSTem:COMMunicate:LAN:APPLy is executed.

NameTypeValuesDescription
addressstring-Default gateway address in nnn.nnn.nnn.nnn format.
string - Returns the default gateway as a string, for example 192.168.1.1.
:SYST:COMM:LAN:GATE 192.168.1.1
:SYST:COMM:LAN:GATE?

Set or query the LAN host name. The host name is an ASCII string up to 99 characters and may include English characters and numbers.

NameTypeValuesDescription
namestring99 charactersSpecified host name.
string - The query returns the host name as a string.
:SYST:COMM:LAN:HOST RIGOL123 /*Set the host name to RIGOL123*/
:SYST:COMM:LAN:HOST? /*Query the host name and the query returns
RIGOL123*/

Sets the IP address or queries the current IP address. The command is only valid when ManualIP configuration mode is on, and the new setting takes effect after :SYSTem:COMMunicate:LAN:APPLy is executed.

NameTypeValuesDescription
ip_addressstring-IP address in nnn.nnn.nnn.nnn format; the first octet ranges from 1 to 223 except 127, and the other three octets range from 0 to 255.
string - Returns the IP address as a string, for example 192.168.1.88.
:SYST:COMM:LAN:IPAD 192.168.1.88
:SYST:COMM:LAN:IPAD?

Queries the MAC address of the instrument. The query returns the MAC address as a string, for example 00-14-0E-42-12-CF.

string - The MAC address of the instrument, returned as a string such as 00-14-0E-42-12-CF.
:SYSTem:COMMunicate:LAN:MAC?

Sets the subnet mask or queries the current subnet mask. The command is only valid when ManualIP configuration mode is on, and the new settings take effect after :SYSTem:COMMunicate:LAN:APPLy is executed.

NameTypeValuesDescription
maskstring-Subnet mask in nnn.nnn.nnn.nnn format, with each nnn ranging from 0 to 255.
string - Returns the current subnet mask as a string, for example 255.255.255.0.
:SYST:COMM:LAN:SMAS 255.255.255.0
:SYST:COMM:LAN:SMAS?

Turns on or off the ManualIP configuration mode. The query returns the current status of the ManualIP configuration mode.

NameTypeValuesDescription
stateenumON | 1 | OFF | 0Selects whether ManualIP configuration mode is enabled or disabled.
enum - Returns the status of the ManualIP configuration mode.
:SYST:COMM:LAN:STAT ON
:SYST:COMM:LAN:STAT?

Store all the modifications of the LAN setting to non-volatile memory and restart the LAN drive program using the updated setting.

Query the USB information of the instrument.

string - Returns a string containing the USB resource information, for example, :USB0::0x1AB1::0x0642::DG1ZA000000001::INSTR.

Sets or queries the type of device connected to the rear-panel USB Device interface. Use COMPuter for a computer connection or PRINter for a printer connection.

NameTypeValuesDescription
modeenumCOMPuter | PRINterSelects the USB device class.
enum - Returns the current USB device class as COMP or PRIN.
:SYST:COMM:USB:CLAS PRIN /*Set the type of the device connected to the USB Device interface at the rear panel of the instrument to printer*/
:SYST:COMM:USB:CLAS? /*Query the type of the device connected to the USB Device interface at the rear panel of the instrument and the query returns PRIN*/
:SYSTem:CSCopyset / query

Copies all parameters, states, and arbitrary waveform data from one channel to the other, except for the channel output on/off state. The two channel names must be different; valid combinations are CH1,CH2 or CH2,CH1.

NameTypeValuesDescription
nameenumCH1 | CH2Channel name to copy from or to.
nameenumCH1 | CH2Channel name to copy to or from.
:SYST:CSC CH1,CH2

Queries and clears an error message in the error queue. The query returns the oldest error as a comma-separated error number and quoted message string.

string - Returns a string with two parts separated by a comma: the error number and the error message in double quotes.

Lock or unlock the front-panel keys. The query checks whether the front-panel keys are locked.

NameTypeValuesDescription
stateenumON | 1 | OFF | 0Locks or unlocks the front-panel keys.
enum - Returns the front-panel key lock state.
:SYST:KLOC 1 /*Lock the front-panel keys*/
:SYST:KLOC? /*Query whether the front-panel keys are locked and the query
returns ON*/
:SYST:KLOC OFF /*Unlock the front-panel keys*/
:SYST:KLOC? /*Query whether the front-panel keys are locked and the query
returns OFF*/
:SYSTem:LANGuageset / query

Sets the system language to English or simplified Chinese. The query returns the current language setting.

NameTypeValuesDescription
languageenumENGLish | SCHineseSystem language to select.
enum - Returns the current system language.
:SYST:LANG SCH /*Set the system language to simplified Chinese*/
:SYST:LANG? /*Query the system language and the query returns SCH*/
:SYSTem:POWeronset / query

Sets the power-on state to default or last. The query returns the current power-on state.

NameTypeValuesDescription
stateenumDEFault | LASTSelects the power-on state to store.
enum - Returns the current power-on state.
:SYST:POW LAST
:SYST:POW?
:SYSTem:PRESetset / query

Restore the instrument to the default state or recall a specified user-stored state file from internal memory.

NameTypeValuesDescription
stateenumDEFault | USER1 | USER2 | USER3 | USER4 | USER5 | USER6 | USER7 | USER8 | USER9 | USER10Selects the default state or one of the stored user state files to recall.
:SYSTem:PRESet
{DEFault|USER1|USER2|USER3|USER4|USER5|USER6|USER7|USER8|USER9|USER10}

Sets the system clock source to internal (INTernal) or external (EXTernal). The query returns the current clock source type.

NameTypeValuesDescription
modeenumINTernal | EXTernalSelects the system clock source.
enum - Returns the current system clock source type.
:SYST:ROSC:SOUR INT /*Set the system clock source to internal*/
:SYST:ROSC:SOUR? /*Query the system clock source and the query returns INT*/

Sanitizes all user-accessible instrument memory information. It also restores the instrument settings to factory values, including user-defined state information, arbitrary waveforms, and I/O settings such as the IP address.

Query the system SCPI version information.

string - Returns the SCPI version as a string in YYYY.V form, where YYYY denotes the year of the version and V denotes the edition in that year.

Sets the burst delay of the specified channel, or queries the burst delay. When <n> is omitted, CH1 is used by default.

NameTypeValuesDescription
<n>optinteger1 - 2Specifies the channel number.
<seconds>real0s - 100sSets the burst delay time.
qualifieroptenumMINimum | MAXimumSelects the minimum or maximum delay value for the query.
real - Returns the burst delay in scientific notation with 7 effective digits.
:TRIG:DEL 1
:TRIG:DEL?

Generates a trigger in the specified channel. If <n> is omitted, the system generates a trigger in CH1 by default.

NameTypeValuesDescription
noptdiscrete1 - 2Specifies the channel number.
:TRIG1 /*Generate a trigger in CH1*/

Sets the trigger input edge type for the specified channel to rising (POSitive) or falling (NEGative). The query returns the current edge type.

NameTypeValuesDescription
noptdiscrete1 - 2Specifies the channel number.
modeenumPOSitive | NEGativeSelects the trigger edge polarity.
enum - Returns the trigger edge type as POS or NEG.
:TRIG1:SLOP NEG
:TRIG1:SLOP?

Sets or queries the trigger source of the specified channel. Applicable only to burst or sweep output; when omitted, <n> defaults to CH1.

NameTypeValuesDescription
noptdiscrete1 - 2Specifies the channel number.
sourceenumINTernal | EXTernal | BUSSelects the trigger source.
enum - The query returns the trigger source as INT, EXT, or MAN.
:TRIG1:SOUR INT /*Set the trigger source of CH1 to internal*/
:TRIG1:SOUR? /*Query the trigger source p of CH1 and the query returns
INT*/