/

Rigol

/

Rigol DG952

SCPI COMMAND REFERENCE

Rigol DG952

Rigol DG952

The Rigol DG952 is Rigol's function/arbitrary waveform generator in the DG900 Series family. Its SCPI remote-control interface exposes 129 commands across 12 subsystems - 111 settable and 18 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.

129

Commands

111

Settable

18

Queries

12

Subsystems

SCPI

Verified

2026-07-16

All commands

:COUNter:AUTOset / query

The instrument will select a proper gate time automatically according to the characteristics of the signal under test after this command is sent.

Sets the coupling mode of the input signal to AC or DC. Queries the coupling mode of the input signal.

NameTypeValuesDescription
{AC|DC}enumAC | DCCoupling mode for the input signal.
enum - The query returns AC or DC.
:COUN:COUP DC /*Sets the coupling mode of the input signal to DC.*/
:COUN:COUP? /*Queries the coupling mode of the input signal and the query returns DC.*/

Selects the gate time of the measurement system. The query reports the current gate time setting.

NameTypeValuesDescription
gate timeenumUSER1 | USER2 | USER3 | USER4 | USER5 | USER6Gate time preset to use for the measurement system.
enum - Returns the gate time setting as USER1 through USER6.
:COUNter:HFset / query

Enables or disables the high frequency rejection function of the frequency counter. The query reports the on/off status of that function.

NameTypeValuesDescription
stateenumON | 1 | OFF | 0Enables or disables high frequency rejection.
enum - Returns the on/off status of the high frequency rejection function.
:COUN:HF ON /*Enables the high frequency rejection function of the frequency counter.*/
:COUN:HF? /*Queries the on/off status of the high frequency rejection function of the frequency counter and the query returns ON.*/
:COUNter:LEVElset / query

Sets the trigger level of the frequency counter. Queries the trigger level of the frequency counter.

NameTypeValuesDescription
valuereal-Trigger level value for the frequency counter.
qualifieroptenumMINimum | MAXimumSelects the minimum or maximum trigger level instead of a numeric value.
returns

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

string - A comma-separated string of five scientific-notation values: frequency, period, duty cycle, positive pulse width, and negative pulse width.
:COUN:MEAS? /*Queries 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 the trigger sensitivity of the frequency counter. The query form returns the current trigger sensitivity.

NameTypeValuesDescription
modeenumLOW | HIGhTrigger sensitivity setting for the frequency counter.
:COUNter:SENSitive {LOW|HIGh}
:COUNter:SENSitive? [LOW|HIGh]
:COUNter[:STATe]set / query

Sets or queries the status of the frequency counter. When enabled, the operating status can be RUN, STOP, or SINGLE; when disabled, the query returns OFF.

NameTypeValuesDescription
stateenumON | 1 | OFF | 0 | RUN | STOP | SINGLEEnables/disables the frequency counter function or sets its operating status.
enum - Returns the current operating status: RUN, STOP, or SINGLE when enabled, and OFF when the frequency counter function is disabled.
:COUN OFF /*Disables the frequency counter function.*/

Clears the statistics results. This command is only valid when the frequency counter statistical function is enabled.

Enables or disables the statistical function of the measurement results of the frequency counter. Queries the on/off status of the statistical function of the measurement results of the frequency counter.

NameTypeValuesDescription
stateoptenumON | 1 | OFF | 0Enables or disables the statistical function of the measurement results of the frequency counter.
enum - The query returns ON or OFF.
:COUN:STATI ON /*Enables the statistical function of the measurement results of the frequency
counter.*/
:COUN:STATI? /*Queries the on/off status of the statistical function of the measurement results of the
counter and the query returns ON.*/

Sets the amplitude deviation in the amplitude coupling of the specified channel. Queries the amplitude deviation in scientific notation with 7 effective digits.

NameTypeValuesDescription
<n>optdiscrete1 - 2Specifies the channel number; when omitted, CH1 is used by default.
<deviation>real-19.998 - 19.998Sets the amplitude deviation.
real (Vpp) - The amplitude deviation in scientific notation, with 7 effective digits.
:COUP1:AMPL:DEV 1 /*Sets the amplitude deviation in the amplitude coupling of CH1 to 1 Vpp.*/
:COUP1:AMPL:DEV? /*Queries the amplitude deviation in the amplitude coupling of CH1 and the
query returns 1.000000E+00.*/

Sets the amplitude coupling mode of the specified channel to OFFSet (amplitude deviation) or RATio (amplitude ratio). Queries the selected amplitude coupling mode of the specified channel.

NameTypeValuesDescription
[<n>]optdiscrete1 - 2Selects the channel number.
modeenumOFFSet | RATioSets the amplitude coupling mode.
enum - Returns the selected amplitude coupling mode of the specified channel.

Sets or queries the amplitude ratio in the amplitude coupling of the specified channel. When the amplitude coupling function is disabled, this command can also switch the mode to amplitude ratio if needed.

NameTypeValuesDescription
[<n>]optdiscrete1 - 2Specifies the channel number; if omitted, CH1 is used by default.
<value>real0.001 - 1000Amplitude ratio value to set.
real - Returns the amplitude ratio in scientific notation with 7 effective digits.
:COUP1:AMPL:RAT 1.123
:COUP1:AMPL:RAT?

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

NameTypeValuesDescription
noptdiscrete1 - 2Channel number; when omitted, CH1 is used by default.
statebooleanON | 1 | OFF | 0Turns amplitude coupling on or off.
enum - Returns the current amplitude coupling status as ON or OFF.

Sets the frequency deviation in the frequency coupling of the specified channel. Queries the frequency deviation in the frequency coupling of the specified channel.

NameTypeValuesDescription
noptdiscrete1 - 2Specified channel number.
deviationreal-99.999 999 999 9 MHz - 99.999 999 999 9 MHzFrequency deviation to set.

Sets or queries the selected frequency coupling mode of the specified channel. The mode can be frequency deviation (OFFSet) or frequency ratio (RATio).

NameTypeValuesDescription
noptinteger1 - 2Channel number to select the specified source.
modeenumOFFSet | RATioFrequency coupling mode to use.
enum - Returns the selected frequency coupling mode.
:COUP1:FREQ:DEV 100
:COUP1:FREQ:DEV?

Sets or queries the frequency ratio in the frequency coupling of the specified channel. The query returns the frequency ratio in scientific notation with 7 effective digits.

NameTypeValuesDescription
noptdiscrete1 - 2Channel number; when omitted, CH1 is used by default.
valuereal0.000 001 - 1 000 000Frequency ratio value.
qualifieroptenumMINimum | MAXimumLiteral keyword alternative to the numeric value.
real - Frequency ratio in scientific notation with 7 effective digits.
:COUP1:FREQ:RAT 100.123 /*Sets the frequency ratio in the frequency coupling of CH1 to 100.123.*/
:COUP1:FREQ:RAT? /*Queries the frequency ratio in the frequency coupling of CH1 and the query returns 1.001230E+02.*/

Enables or disables the frequency coupling function of the specified channel. Queries the on/off status of the frequency coupling function of the specified channel.

NameTypeValuesDescription
[<n>]optdiscrete1 - 2Specifies the channel number; when omitted, CH1 is used by default.
stateenumON | 1 | OFF | 0Enables or disables frequency coupling.
enum - Returns the on/off status of the frequency coupling function.

Sets the phase deviation in the phase coupling of the specified channel. Queries the phase deviation in the phase coupling of the specified channel.

NameTypeValuesDescription
[<n>]optinteger1 - 2Specifies the channel; if omitted, CH1 is used by default.
deviationreal-360° - 360°Sets the phase deviation.
real (°) - Returns the phase deviation.

Sets the phase coupling mode of the specified channel to phase deviation (OFFSet) or phase ratio (RATio). Queries the selected phase coupling mode of the specified channel.

NameTypeValuesDescription
[<n>]optdiscrete1 - 2Specifies the channel number; when omitted, CH1 is used by default.
modeenumOFFSet | RATioSelects phase deviation or phase ratio mode.
enum - Returns the current phase coupling mode.
:COUP1:PHAS:MODE OFFS
:COUP1:PHAS:MODE?

Sets the phase ratio in the phase coupling of the specified channel. Queries the phase ratio in the phase coupling of the specified channel.

NameTypeValuesDescription
[<n>]optdiscrete1 - 2Specifies the channel number; if omitted, CH1 is used by default.
<value>real0.01 - 100Sets the phase ratio.
qualifieroptenumMINimum | MAXimumSelects the minimum or maximum allowed phase ratio.
real - Returns the phase ratio in scientific notation with 7 effective digits.
:COUP1:PHAS:RAT 1.12 /*Sets the phase ratio in the phase coupling of CH1 to 1.12.*/
:COUP1:PHAS:RAT? /*Queries the phase ratio in the phase coupling of CH1 and the query returns 1.120000E+00.*/

Enables or disables the phase coupling function of the specified channel. Queries the on/off status of the phase coupling function of the specified channel.

NameTypeValuesDescription
[<n>]optdiscrete1 - 2Specifies the channel number; when omitted, CH1 is used by default.
statebooleanON | 1 | OFF | 0Turns the phase coupling function on or off.
enum - Returns the on/off status of the phase coupling function.
:COUP1:PHAS:STAT ON
:COUP1:PHAS:STAT?

Enables or disables the frequency coupling, phase coupling, and amplitude coupling of the specified channel at the same time. The query returns a comma-separated status string for frequency, phase, and amplitude coupling.

NameTypeValuesDescription
<n>optdiscrete1 - 2Channel number to target; omitted value defaults to CH1.
stateenumON | 1 | OFF | 0Turns the coupling state on or off.
string - Returns the on/off status of the frequency coupling, phase coupling, and amplitude coupling functions in sequence, separated by commas (for example, FREQ:ON,PHASE:OFF,AMPL:OFF).
:COUP1 ON
:COUP1?

Enables or disables the trigger coupling function of the specified channel. Queries the on/off status of the trigger coupling function of the specified channel.

NameTypeValuesDescription
noptdiscrete1 - 2Specifies the channel number; when omitted, CH1 is used by default.
stateenumON | 1 | OFF | 0Turns trigger coupling on or off.
enum - Returns the on/off status of the trigger coupling function.
:COUP1:TRI ON
:COUP1:TRI?

Sets the screen brightness. Queries the screen brightness.

NameTypeValuesDescription
brightnessinteger1% - 100%Screen brightness level.
qualifieroptenumMINimum | MAXimumOptional query qualifier.
integer - The query returns the screen brightness in scientific notation.
:DISP:BRIG 51
:DISP:BRIG?

Enables or disables the screen saver function. The query returns the current on/off status of the screen saver function.

NameTypeValuesDescription
stateenumON | 1 | OFF | 0Sets the screen saver function state.
enum - Returns ON or OFF, indicating the current status of the screen saver function.
:DISP:SAV OFF
:DISP:SAV?
:DISP:SAV 1
:DISP:SAV?

Queries the image of the front panel screen (screenshot).

definite_length_block - The query returns a definite-length binary data block that contains the image. The block starts with #.

Sets or queries the format of the returned screenshot image. The format can be BMP or PNG.

NameTypeValuesDescription
formatenumBMP | PNGImage format for the screenshot return data.
:HCOP:SDUM:DATA:FORM BMP
:HCOP:SDUM:DATA:FORM?

*CLSset / query

Clears the event registers in all the register sets and clears the error queue.

*ESEset / query

Enables the bits in the standard event register to be reported to the status byte register. The query returns the bit enabled in the standard event register.

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

Queries the event register of the standard event register. The register is read-only and is cleared when queried; later events for a latched bit are ignored until the register is cleared by this query or by *CLS.

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

Queries the ID string of the instrument.

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

Sets the OPC (operation complete) bit in the standard event register to 1 after all previous commands are executed. The query form reports whether all previously sent commands have executed.

*PSCset / query

Enables or disables clearing of the status byte enable register and standard event enable register at power-on. Queries whether to clear those registers at power-on.

NameTypeValuesDescription
{0|1}enum0 | 1Clears or does not clear the status byte enable register and standard event enable register at power-on.
enum - Returns whether clearing of the status byte enable register and standard event enable register at power-on is enabled.
*PSC 1
*PSC?
*RCLset / query

Recalls the state file stored in the specified internal non-volatile memory location.

NameTypeValuesDescription
locationdiscrete0 | 1 | 2 | 3 | 4 | 5Specifies the storage location number of the state file to recall.
*RSTset / query

Restores the instrument to its factory default state.

*SAVset / query

Stores the current instrument state in the specified storage location of the internal non-volatile memory with the default name.

NameTypeValuesDescription
{0|1|2|3|4|5}discrete0 - 5Storage location number for the instrument state file.
*SREset / query

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

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

Queries the status register of the status byte register. It cannot clear the service request, and bit6 (master summary bit) remains set while the request condition is still true.

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

Triggers a sweep or a burst.

*WAIset / query

Executes 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.

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

integer - Returns a fixed value of 6.

Queries the state files stored in the instrument's internal non-volatile memory. The response is a comma-separated string of 6 quoted filenames, one for each storage location.

string - A string consisting of 6 parts representing the filenames stored in locations 1 to 6, separated by commas. An empty pair of double quotation marks is returned for any location with no stored file.

Deletes the state file stored in the specified location of the instrument's internal non-volatile memory.

NameTypeValuesDescription
locationenum0 | 1 | 2 | 3 | 4 | 5Storage location of the state file to delete.
:MEM:STAT:DEL 1

Modifies the filename of the state file stored in the specified storage location of the internal non-volatile memory, or queries the filename for that location. The filename parameter is optional in the setter; if omitted, the filename is empty.

NameTypeValuesDescription
locationdiscrete0 - 5Storage location of the state file.
nameoptstring-Filename to assign to the state file.

Recalls the instrument configuration to last (ON or 1) or default (OFF or 0) at the next power-on. The query reports whether auto recall is set to ON or OFF.

NameTypeValuesDescription
stateenumON | 1 | OFF | 0Selects last configuration recall at power-on or factory default recall at power-on.
enum - Returns whether auto recall is enabled or disabled for the next power-on.
:MEM:STAT:RECall:AUTO ON
:MEM:STAT:RECall:AUTO?

Queries whether a state file is found in the specified storage location of the internal non-volatile memory of the instrument.

NameTypeValuesDescription
locationdiscrete0 - 5Storage location index for the state file.
enum - Returns 1 if a state file is already found in the specified storage location, and 0 if no state file is found.

Queries all the files and folders in the current directory.

NameTypeValuesDescription
folderoptstring-Valid directory in the internal or external memory; a string enclosed by double quotation marks.
string - Returns a string listing space used, space available, and the entries in the current directory in the format "space used,space available,\"size,property,name\",……". The units of space used and space available are bytes.

Queries the arbitrary waveform file and sequence file (*.RAF) under the current operation directory.

NameTypeValuesDescription
folderoptstring-A valid directory in the internal or external memory, enclosed by double quotation marks.
string - Returns a string listing the space used and space available, followed by file entries in the format "size,property,name".
:MMEM:CAT:DATA:ARB? /*Queries the arbitrary waveform file and sequence file in the external memory directory and the query returns 28672,4102361088,"80,,Rigol1.RAF".*/

Queries the state file under the current operation directory.

NameTypeValuesDescription
folderoptstring-Valid directory in the internal or external memory, enclosed by double quotation marks.
string - Returns a string listing the files and folders in the specified folder, in the format space used,space available,"size,property,name",… .
:MMEMory:CATalog:STATe? [<folder>]

Sets the current directory. Queries the current directory.

NameTypeValuesDescription
directory_namestringValid directoryValid directory in the internal or external memory, enclosed by double quotation marks.
string - The current directory, enclosed by double quotation marks.
:MMEM:CDIR "D:\" /*Sets the current directory to Disk D (external memory).*/
:MMEM:CDIR? /*Queries the current directory and the query returns "D:".*/
:MMEMory:COPYset / query

Copies a file from the current directory to a specified directory. The destination must be a directory other than the current directory.

NameTypeValuesDescription
directory_namestring-Destination directory for the copied file.
file_namestring-Filename of the file under the current directory to copy.
:MMEMory:DELeteset / query

Deletes the specified file or empty folder from the current directory.

NameTypeValuesDescription
file_namestring-Filename of the file or the folder name of the empty folder under the current directory.
:MMEM:DEL " D:\Rigol1.RAF" /*Deletes the file Rigol1.RAF from the external memory (D:\).*/

Creates a file under the current directory. The file name must be a quoted ASCII string and cannot exceed 7 characters.

NameTypeValuesDescription
file_namestring-Valid filename for the file to be created under the current directory.
:MMEMory:DOWNload:FNAMe <file_name>

Loads binary data into the currently created file.

NameTypeValuesDescription
binary_blockstring-Binary data to load into the currently created file.

Loads the specified state file or arbitrary waveform file under the current path.

NameTypeValuesDescription
file_namestring-The filename of the state file or the arbitrary waveform file in the current directory.
:MMEM:LOAD "Rigol0.RSF" /*Loads the file Rigol0.RSF from the external memory (D:\).*/

Loads the specified arbitrary waveform file and sequence file from the current directory into the specified channel. If the channel index is omitted, the file is loaded into CH1 by default.

NameTypeValuesDescription
noptinteger1 - 2Specifies CH1 or CH2 as the destination channel.
file_namestring-Filename of the arbitrary waveform file and sequence file in the current directory, enclosed in double quotation marks.
:MMEM:LOAD:DATA "Rigol4.RAF" /*Loads the arbitrary waveform file Rigol4.RAF in the current directory (D:\Rigol) into the current channel.*/

Loads the specified state file from the current directory.

NameTypeValuesDescription
file_namestring-The filename of the state file in the current directory.
:MMEM:LOAD:STAT "D:\Rigol0.RSF" /*Loads the state file Rigol0.RSF from the external memory (D:\).*/

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

NameTypeValuesDescription
dir_namestring-Name of the folder to be created; must be enclosed in double quotation marks.
:MMEM:MDIR "RIGOL1" /*Creates a folder named "RIGOL1" under the directory of Disk D.*/
:MMEMory:MOVEset / query

Moves file 1 from the current directory to path 2.

NameTypeValuesDescription
file1string-The file in the current directory; a string enclosed by double quotation marks.
file2string-A valid directory in the internal or external memory; a string enclosed by double quotation marks.
:MMEM:MOVE "D:\Rigol.RSF","D:\Rigol" /*Moves the file Rigol.RSF from the external memory
directory to "D:\Rigol" (i.g. the Rigol folder in Disk D).*/

Queries the available disk drive.

string - Returns a string containing the number of disk drives available and the names of the available disk drives. If no disk drive is available, it returns "0,\"NULL\"".

Deletes the specified directory (empty folder) in the current path.

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

Stores the current instrument state or the arbitrary waveform data of the current channel into the current directory with the specified filename. The filename is given as a quoted ASCII string and includes the file suffix (.RSF or .RAF).

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

Stores the arbitrary waveform or sequence data of the specified channel into the current directory as an arbitrary waveform file or sequence file (*.RAF) with the specified filename.

NameTypeValuesDescription
noptdiscrete1 | 2Specifies the channel whose arbitrary waveform or sequence data is stored.
file_namestring-Filename of the specified arbitrary waveform or sequence file.
:MMEM:STOR:DATA "R11.RAF" /*Stores the arbitrary waveform data of the current channel into Disk D in arbitrary waveform file form with the filename R11.RAF.*/

Stores the current instrument state into the current directory in state file form with the specified filename.

NameTypeValuesDescription
file_namestring-Filename of the state file, enclosed in double quotation marks and including the .RSF suffix.
:MMEM:STOR:STAT "R22.RSF" /*Stores the current instrument state into Disk D in state file form with
the filename R22.RSF.*/

Sets or queries the output impedance of the specified channel output connector.

NameTypeValuesDescription
[<n>]optdiscrete1 - 2Selects the channel number; if omitted, CH1 is used by default.
ohmsinteger1 Ω - 10 kΩSets the output impedance to a specified value within the available range.
qualifieroptenumMINimum | MAXimumOptional query qualifier that returns the minimum or maximum output impedance.
numeric (Ω) - Returns the output impedance in scientific notation with 7 effective digits. If the output impedance is set to INFinity, the query returns 9.900000E+37.

Sets the output impedance/load of the specified channel, or queries the current value. The value may be a resistance, INFinity, MINimum, or MAXimum.

NameTypeValuesDescription
[<n>]optdiscrete1 - 2Specifies the channel number; if omitted, CH1 is used by default.
<ohms>integer1 Ω - 10 kΩSets the output impedance to the specified resistance value.
qualifieroptenumMINimum | MAXimumSelects the minimum or maximum allowed impedance value.
numeric (Ω) - Returns the output impedance in scientific notation with 7 effective digits. If the output impedance is set to INFinity, the query returns 9.900000E+37.

Sets the output polarity of the specified channel to normal or inverted. Queries the output polarity of the specified channel.

NameTypeValuesDescription
[<n>]optdiscrete1 - 2Specifies the channel number; when omitted, CH1 is used by default.
modeenumNORMal | INVertedSets the output polarity to normal or inverted.
enum - Returns the current output polarity.
:OUTP1:POL NORM /*Sets the output polarity of CH1 to Normal.*/
:OUTP1:POL? /*Queries the output polarity of CH1 and the query returns NORM.*/

Enables or disables the output of the specified channel. Queries the output status of the specified channel.

NameTypeValuesDescription
[<n>]optdiscrete1 - 2Channel number; when omitted, CH1 is used by default.
statebooleanON | 1 | OFF | 0Sets the output state to on or off.
enum - Returns the output status of the specified channel.

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

NameTypeValuesDescription
noptinteger1 - 2Specifies the output channel number; if omitted, CH1 is used by default.
polarityenumPOSitive | NEGativeSets the sync signal polarity to normal or inverted.

Enables or disables the sync signal output from the rear-panel [Sync/Ext Mod/Trig/FSK] connector of the specified channel. Queries the output status of the sync signal output from the rear-panel [Sync/Ext Mod/Trig/FSK] connector of the specified channel.

enum - The query returns ON or OFF.

Sets or queries the high level amplitude of the voltage limit for the selected output channel. When [<n>] is omitted, CH1 is used by default.

NameTypeValuesDescription
[<n>]optdiscrete1 - 2Selects the output channel.
amprealVHigh level amplitude of the voltage limit.
real - The high level limit value in scientific notation with 7 effective digits.
:OUTP1:VOLLimit:HIGH 1
:OUTP1:VOLLimit:HIGH?

Sets the low level amplitude of the voltage limit. Queries the low level limit value.

NameTypeValuesDescription
[<n>]optdiscrete1 - 2Selects the channel; when omitted, CH1 is used by default.
amprealVLow level amplitude of the voltage limit.
real - Returns the low level limit value in scientific notation with 7 effective digits.
:OUTP1:VOLLimit:LOW /*Sets the low level amplitude of voltage limit of CH1 to -1 V.*/
:OUTP1:VOLLimit:LOW? /*Queries the low level amplitude of voltage limit of CH1 and returns
-1.000000E+00.*/

Enables or disables the voltage limit. Queries the on/off status of the voltage limit.

NameTypeValuesDescription
[<n>]optinteger1 - 2Selects the channel; when omitted, CH1 is used by default.
statebooleanON | 1 | OFF | 0Turns the voltage limit on or off.
enum - Returns ON or OFF.
:OUTP1:VOLLimit? /*Queries the on/off status of the voltage limit of CH1 and the query returns OFF.*/
:OUTP1:VOLLimit ON /*Enables the voltage limit of CH1.*/
:OUTP1:VOLLimit? /*Queries the on/off status of the voltage limit of CH1 and the query returns ON.*/

Sets the system clock source to internal source (INTernal) or external source (EXTernal).

NameTypeValuesDescription
modeenumINTernal | EXTernalSelects the system clock source.
:ROSC:SOUR INT /*Sets the system clock source to Internal.*/

Queries the currently selected system clock source.

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

:SOURce:APPLyset / query

Sets or queries the waveform type and associated settings of the specified source channel. For the query, it returns the waveform name plus the frequency, amplitude, offset, and phase of the channel.

NameTypeValuesDescription
[<n>]optdiscrete1 - 2Source channel number; if omitted, CH1 is used by default.
string - Quoted, comma-separated string containing waveform name, frequency, amplitude, offset, and phase for the specified channel; absent items are replaced by DEF.
:SOUR1:APPL? /*Queries the waveform type as well as the frequency, amplitude, offset, and phase of CH1;
the query returns SQU,1.000000E+03,2.000000E+00,3.000000E+00,4.000000E+00".*/
:SOURce:BURStset / query

Sets or queries the burst mode for the specified channel. The burst type can be N cycle, Infinite, or Gated.

NameTypeValuesDescription
[<n>optdiscrete1 - 2Channel number; if omitted, CH1 is used by default.
modeenumTRIGgered | INFinity | GATedSelects the burst type.
enum - Returns the burst type of the specified channel.
:SOUR1:BURS:MODE TRIG /*Sets the burst type of CH1 to TRIG (N cycle).*/
:SOUR1:BURS:MODE? /*Queries the burst type of CH1 and the query returns TRIG.*/

Sets or queries the sweep center frequency for the specified channel. The query returns the center frequency in scientific notation with 7 effective digits, and may be qualified with MINimum or MAXimum.

NameTypeValuesDescription
[<n>]optinteger1 - 2Channel number.
frequencyrealHzCenter frequency to set.
qualifieroptenumMINimum | MAXimumReturns the minimum or maximum center frequency.
real (Hz) - Center frequency in scientific notation with 7 effective digits.
:SOUR1:FREQ:CENT 500
:SOUR1:FREQ:CENT?
:SOURce:FUNCtionset / query

Sets or queries the function of the specified source channel. The slice only shows this command as a parent heading and a command list, but does not document its own syntax, parameters, or return value here.

:SOURce:HARMonicset / query

Sets or queries the harmonic function for the specified channel. The slice’s examples and detailed parameter/return documentation are for related subcommands; this mnemonic itself is documented only as the command-list entry for the harmonic function state node.

:SOURce:MARKerset / query

Sets or queries the marker frequency of the specified source channel. The frequency must lie between the start and stop frequencies; if omitted, CH1 is used by default.

NameTypeValuesDescription
<n>optdiscrete1 - 2Source channel number.
<frequency>realHzMarker frequency to set.
qualifieroptenumMINimum | MAXimumReturns the minimum or maximum allowed marker frequency.
real (Hz) - Returns the marker frequency in scientific notation with 7 effective digits.
[:SOURce[<n>]]:MARKer:FREQuency {<frequency>|MINimum|MAXimum}
[:SOURce[<n>]]:MARKer:FREQuency? [MINimum|MAXimum]
:SOUR1:MARK:FREQ 500
:SOUR1:MARK:FREQ?
:SOURce[:MOD]:AMset / query

Sets the AM modulation source of the specified channel to internal or external modulation source. Queries the AM modulation source of the specified channel.

NameTypeValuesDescription
[<n>]optdiscrete1 - 2Specifies the channel number.
sourceenumINTernal | EXTernalSelects the AM modulation source.
enum - Returns the AM modulation source.
[:SOURce[<n>]][:MOD]:AM:SOURce {INTernal|EXTernal}
[:SOURce[<n>]][:MOD]:AM:SOURce?

Sets or queries ASK modulation settings for the specified channel. This command group includes amplitude, internal rate, polarity, source, and state subcommands.

:SOURce[:MOD]:FMset / query

Sets or queries the FM frequency deviation of the specified channel. The query returns the deviation in scientific notation with 7 effective digits.

NameTypeValuesDescription
[<n>]discrete1 - 2Channel number.
deviationreal-FM frequency deviation.
qualifieroptenumMINimum | MAXimumReturns the minimum or maximum deviation.
real - Frequency deviation in scientific notation with 7 effective digits.
[:SOURce[<n>]][:MOD]:FM[:DEViation] {<deviation>|MINimum|MAXimum}
[:SOURce[<n>]][:MOD]:FM[:DEViation]? [MINimum|MAXimum]

Sets the FSK hop frequency of the specified channel. Queries the FSK hop frequency of the specified channel.

NameTypeValuesDescription
[<n>]discrete1 - 2
frequencyrealHzFrequency range of the specified channel.
qualifieroptenumMINimum | MAXimumOptional query qualifier for requesting the minimum or maximum frequency.
real - Returns the FSK hop frequency in scientific notation, with 7 effective digits.
:SOURce[:MOD]:PMset / query

Sets or queries the PM phase deviation of the specified channel. When omitted, CH1 is used by default.

NameTypeValuesDescription
[<n>]optdiscrete1 - 2Specifies the channel number.
deviationreal0° - 360°Sets the PM phase deviation.
qualifieroptenumMINimum | MAXimumSelects the minimum or maximum phase deviation for the query.
real (°) - Returns the PM phase deviation in scientific notation with 7 effective digits.
[:SOURce[<n>]][:MOD]:PM[:DEViation] {<deviation>|MINimum|MAXimum}
[:SOURce[<n>]][:MOD]:PM[:DEViation]? [MINimum|MAXimum]
:SOUR1:PM 50 /*Sets the PM phase deviation of CH1 to 50°.*/
:SOUR1:PM? /*Queries the PM phase deviation of CH1 and the query returns 5.000000E+01.*/

Enables or disables the PSK modulation function of the specified channel. Queries the on/off status of the PSK modulation function of the specified channel.

NameTypeValuesDescription
[<n>]discrete1 - 2Specifies the channel number.
statebooleanON | 1 | OFF | 0Turns PSK modulation on or off.
enum - Returns ON or OFF.
:SOUR1:PSK:STAT ON
:SOUR1:PSK:STAT?

Sets or queries the PWM modulation function of the specified channel.

NameTypeValuesDescription
[<n>]discrete1 - 2Channel number.
stateenumON | 1 | OFF | 0Enables or disables PWM modulation.
enum - Returns the on/off status of the PWM modulation function.
:SOUR1:PWM:STAT ON /*Sets the PWM modulation source of CH1 to external modulation source.*/
:SOUR1:PWM:STAT? /*Queries the PWM modulation source of CH1 and the query returns EXT.*/
:SOURce:MODset / query

Enables or disables the modulation function of the specified channel. Queries the on/off status of the modulation function of the specified channel.

NameTypeValuesDescription
[<n>]optdiscrete1 - 2Specifies the channel number.
stateenumON | 1 | OFF | 0Enables or disables the modulation function.
:SOUR1:MOD ON /*Enables the modulation function of CH1.*/
:SOUR1:MOD? /*Queries the on/off status of the modulation function of CH1 and the query returns ON.*/
:SOURce:PERiodset / query

Sets or queries the waveform period of the specified channel for basic and arbitrary waveforms. When the channel is omitted, CH1 is used by default.

NameTypeValuesDescription
[<n>]optdiscrete1 | 2Specifies the channel number.
periodreal-Sets the waveform period.
string - The query returns the waveform period in scientific notation with 7 effective digits.
:SOUR1:PER 0.1 /*Sets the waveform period of CH1 to 1 s.*/
:SOUR1:PER? /*Queries the waveform period of CH1 and the query returns 1.000000E-01.*/
:SOURce:PHASeset / query

Sets the waveform start phase of the specified channel. The query returns the waveform start phase in scientific notation with 7 effective digits.

NameTypeValuesDescription
[<n>]optdiscrete1 - 2Specifies the channel number; when omitted, CH1 is used by default.
phasereal0° - 360°Sets the start phase.
qualifieroptenumMINimum | MAXimumOptional query qualifier to return the minimum or maximum start phase.
real (°) - Waveform start phase in scientific notation with 7 effective digits.
:SOUR1:PHAS 10 /*Sets the start phase of CH1 to 10°.*/
:SOUR1:PHAS? /*Queries the start phase of CH1 and the query returns 1.000000E+01.*/
:SOURce:PULSeset / query

Sets the pulse settings for the specified channel. This page lists the pulse duty cycle, rise time, and fall time commands under the PULSE subsystem, with CH1 used by default when the channel is omitted.

NameTypeValuesDescription
[<n>]optdiscrete1 - 2Channel number to which the pulse settings apply.
:SOURce:SUMset / query

Enables or disables the waveform combine function of the specified channel. Queries the on/off status of the waveform combine function of the specified channel.

NameTypeValuesDescription
[<n>]optdiscrete1 - 2Specifies the channel number.
stateenumON | 1 | OFF | 0Turns waveform combine on or off.
[:SOURce[<n>]]:SUM[:STATe] {ON|1|OFF|0}
[:SOURce[<n>]]:SUM[:STATe]?
:SOURce:SWEepset / query

Enables, disables, or configures the sweep function for the specified channel. The slice documents several child commands under :SOURce:SWEep, including sweep spacing, state, step count, and hold/return times.

:SOURce:TRACeset / query

Downloads a waveform table to the DDRIII internal memory. The command consists of a command string plus binary data; the flag indicates whether more data packages follow or this is the last package.

NameTypeValuesDescription
noptdiscrete1 - 2Selects the source channel; if omitted, CH1 is used by default.
flagstring-Data transmission status flag; can be CON or END.
datablock16Bytes - 32kBytesBinary waveform data to be downloaded.
:SOURce:TRACKset / query

Sets the state of the track function of the specified channel to ON, OFF, or INVerted. Queries the state of the track function of the specified channel.

NameTypeValuesDescription
[<n>]optdiscrete1 - 2Specifies the channel number; when omitted, CH1 is used by default.
stateenumON | OFF | INVertedSets the track function state.
enum - Returns the current track function state of the specified channel.
:SOUR1:TRACK ON /*Sets the state of the track function of CH1 to ON.*/
:SOUR1:TRACK? /*Queries the state of the track function of CH1 and the query returns ON.*/
:SOURce:VOLTageset / query

Sets or queries the waveform voltage amplitude of the specified channel. The query can also return the minimum or maximum amplitude when followed by MINimum or MAXimum.

NameTypeValuesDescription
<n>optdiscrete1 - 2Selects the channel number.
<amplitude>real2 mVppSets the waveform amplitude of the specified channel.
qualifieroptenumMINimum | MAXimumFor the query, returns the minimum or maximum amplitude.
real - Returns the waveform amplitude in scientific notation with 7 effective digits; MINimum or MAXimum return the corresponding limit.
:SOUR1:VOLT 5 /*Sets the waveform amplitude of CH1 to 5 Vpp.*/
:SOUR1:VOLT? /*Queries the waveform amplitude of CH1 and the query returns 5.000000E+00.*/

The beeper sounds immediately. The current on/off status of the beeper is ignored by this command.

Turns on or off the beeper. Queries the on/off status of the beeper.

NameTypeValuesDescription
stateenumON | 1 | OFF | 0Sets the beeper on or off.
:SYST:BEEP:STAT 1 /*Turns on the beeper.*/
:SYST:BEEP:STAT? /*Queries the on/off status of the beeper and the query returns ON.*/

Selects the current channel. Queries the current channel.

NameTypeValuesDescription
modeenumCH1 | CH2
enum - The query returns CH1 or CH2.

Queries the number of output channels of the instrument.

integer - The number of output channels.
:SYST:CHAN:NUM? /*Queries the number of the output channels of the instrument and the query returns 2.*/

Sets or queries the instrument's GPIB address. The address is an integer in the range 0 to 30, with default 2.

NameTypeValuesDescription
integerinteger0 - 30GPIB address to set.
integer - The query returns the GPIB address.
:SYST:COMM:GPIB:ADDR 7 /*Sets the GPIB address of the instrument to 7.*/
:SYST:COMM:GPIB:ADDR? /*Queries the GPIB address of the instrument and the query returns 7.*/

Applies the currently set network parameters. The new LAN settings take effect only when this command is executed after setting the LAN parameters.

Enables or disables the AutoIP configuration mode. The query returns the current AutoIP status.

NameTypeValuesDescription
stateenumON | 1 | OFF | 0Sets the AutoIP configuration mode on or off.
enum - Returns the AutoIP configuration mode status.
:SYST:COMM:LAN:AUTO OFF /*Disables the AutoIP configuration mode.*/
:SYST:COMM:LAN:AUTO? /*Queries the status of the AutoIP configuration mode and the query returns OFF.*/

Reads the port number of the initial control connecting port for socket communication.

integer - Returns 5555 if socket communication is supported; otherwise returns 0.

Enables or disables the DHCP configuration mode. The query returns the current DHCP status.

NameTypeValuesDescription
stateoptenumON | 1 | OFF | 0Enables or disables DHCP configuration mode.
enum - Returns the DHCP configuration mode status.

Sets the DNS address. Queries the DNS address.

NameTypeValuesDescription
addressstring-DNS address to set.

Sets the default gateway. Queries the default gateway.

NameTypeValuesDescription
addressstring-IPv4 address in the form nnn.nnn.nnn.nnn.
string - The query returns the default gateway address.
:SYST:COMM:LAN:GATE 192.168.1.1 /*Sets the default gateway to 192.168.1.1.*/
:SYST:COMM:LAN:GATE? /*Queries the default gateway and the query returns
192.168.1.1.*/

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

NameTypeValuesDescription
ip_addressstring-IP address in the form nnn.nnn.nnn.nnn.
string - Returns the current IP address as a string, for example 192.168.1.88.
:SYST:COMM:LAN:IPAD 192.168.1.88
:SYST:COMM:LAN:IPAD?

Sets the subnet mask. 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
maskstring-Subnet mask in the form nnn.nnn.nnn.nnn; nnn ranges from 0 to 255 and the mask must be continuous.

Enables or disables the manual IP configuration mode. Queries the status of the manual IP configuration mode.

NameTypeValuesDescription
stateenumON | 1 | OFF | 0Sets the manual IP configuration mode.
enum - Returns the status of the manual IP configuration mode.
:SYST:COMM:LAN:STAT ON /*Enables the ManualIP configuration mode.*/
:SYST:COMM:LAN:STAT? /*Queries the status of the ManualIP configuration mode and the query returns ON.*/

Queries the USB information of the instrument.

string - Returns the USB information as a string, for example :USB0::0x1AB1::0x0642::DG80000000001::INSTR.
:SYSTem:CSCopyset / query

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

NameTypeValuesDescription
nameenumCH1 | CH2Selects the source and destination channels for the copy operation.
nameenumCH1 | CH2Selects the source and destination channels for the copy operation.
:SYST:CSC CH1,CH2 /*Copies all parameters and states (except the channel output state) and arbitrary waveform data of CH1 to CH2.*/

Queries and clears an error message from the error queue.

string - Returns a comma-separated string containing the error number and the error message content in double quotation marks.
:SYSTem:KLOCkset / query

Locks or unlocks the specified key or knob. The query checks whether the specified key or knob is locked.

NameTypeValuesDescription
keyenum-The specified key or knob to lock or unlock.
stateenumON | 1 | OFF | 0Selects whether the specified key or knob is locked or unlocked.
:SYSTem:LANGuageset / query

Sets the system language to English or Simplified Chinese. Queries the current system language.

NameTypeValuesDescription
languageenumENGLish | SCHineseSystem language to set.
enum - Returns the current system language.
:SYST:LANG SCH /*Sets the system language to Simplified Chinese.*/
:SYST:LANG? /*Queries the system language and the query returns SCH.*/

Enables or disables the system log. Queries the on/off status of the system log.

NameTypeValuesDescription
statebooleanON | 1 | OFF | 0Turns the system log on or off.
enum - The query returns the current system log status.
:SYST:LOG 1
:SYST:LOG?
:SYSTem:POWeronset / query

Sets the power-on state to Default or Last. Queries the power-on state.

NameTypeValuesDescription
modeenumDEFault | LASTSelects the power-on state to use at startup.

Deletes the specified user-stored state file in the instrument's internal memory. The file can only be deleted when the specified storage location contains a state file.

NameTypeValuesDescription
state fileenumUSER1 | USER2 | USER3 | USER4 | USER5 | USER6 | USER7 | USER8 | USER9 | USER10Specifies which user-stored state file to delete.
:SYSTem:PRESet:DELete USER1 /*Deletes the state file stored in the state file storage locations 1 in
the internal memory of the instrument*/

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

NameTypeValuesDescription
modeenumDEFault | 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:RECall USER1

Saves the current system status to the specified user storage location in the internal memory of the instrument.

NameTypeValuesDescription
locationenumUSER1 | USER2 | USER3 | USER4 | USER5 | USER6 | USER7 | USER8 | USER9 | USER10User storage location to save the current system status.
:SYSTem:PRESet:SAVe USER1 /*Saves the system status to the user storage location 1 in the internal memory of the instrument.*/

Queries user-defined system status names. The query returns 10 system status names; if User n saved the current system status, the query returns that status name.

string - Returns 10 system status names, such as "Default" or "User2", with empty strings for unused entries.

Sets the system clock source to internal or external. The query returns the current clock source type.

NameTypeValuesDescription
sourceenumINTernal | EXTernalSelects the system clock source.
enum - Returns the current system clock source type.
:SYST:ROSC:SOUR INT
:SYST:ROSC:SOUR?

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

NameTypeValuesDescription
<n>optinteger1 - 2Specifies the channel number.
<seconds>real0 s - 100 sSets the burst delay.
qualifieroptenumMINimum | MAXimumSelects the minimum or maximum burst delay when used in the query form.

Generates a trigger on the specified channel. When [<n>] is omitted, the system generates a trigger on CH1 by default.

NameTypeValuesDescription
noptdiscrete1 | 2Specifies the channel number.
:TRIG1 /*Generates a trigger on CH1.*/

Sets the edge type of the trigger input signal of the specified channel to rising (POSitive) or falling (NEGative). Queries the edge type of the trigger input signal of the specified channel.

NameTypeValuesDescription
<n>optdiscrete1 - 2Specifies the channel number.
stateenumPOSitive | NEGativeSelects the trigger edge polarity.
enum - Returns the trigger edge type as POS or NEG.
:TRIG1:SLOP NEG /*Sets the edge type of the trigger input signal of CH1 to Falling edge.*/
:TRIG1:SLOP? /*Queries the edge type of the trigger input signal of CH1 and the query returns NEG.*/

Sets or queries the trigger source of the specified channel. The source can be Internal, External, or Manual.

NameTypeValuesDescription
[<n>]optdiscrete1 - 2Specifies the channel number; if omitted, CH1 is used by default.
sourceenumINTernal | EXTernal | BUSSelects the trigger source.
enum - Returns the current trigger source as INT, EXT, or BUS.
:TRIG1:SOUR INT /*Sets the trigger source of CH1 to Internal.*/
:TRIG1:SOUR? /*Queries the trigger source of CH1 and the query returns INT.*/