The instrument will select a proper gate time automatically according to the characteristics of the signal under test after this command is sent.
SCPI COMMAND REFERENCE
The Rigol DG972 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
Sets the coupling mode of the input signal to AC or DC. Queries the coupling mode of the input signal.
| Name | Type | Values | Description |
|---|---|---|---|
| {AC|DC} | enum | AC | DC | Coupling mode for the input signal. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| gate time | enum | USER1 | USER2 | USER3 | USER4 | USER5 | USER6 | Gate time preset to use for the measurement system. |
Enables or disables the high frequency rejection function of the frequency counter. The query reports the on/off status of that function.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | Enables or disables high frequency rejection. |
: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.*/
Sets the trigger level of the frequency counter. Queries the trigger level of the frequency counter.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | - | Trigger level value for the frequency counter. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum trigger level instead of a numeric value. |
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.
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | LOW | HIGh | Trigger sensitivity setting for the frequency counter. |
:COUNter:SENSitive {LOW|HIGh}
:COUNter:SENSitive? [LOW|HIGh]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.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | RUN | STOP | SINGLE | Enables/disables the frequency counter function or sets its operating status. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| stateopt | enum | ON | 1 | OFF | 0 | Enables or disables the statistical function of the measurement results of the frequency counter. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| <n>opt | discrete | 1 - 2 | Specifies the channel number; when omitted, CH1 is used by default. |
| <deviation> | real | -19.998 - 19.998 | Sets the amplitude deviation. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Selects the channel number. |
| mode | enum | OFFSet | RATio | Sets the amplitude coupling mode. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Specifies the channel number; if omitted, CH1 is used by default. |
| <value> | real | 0.001 - 1000 | Amplitude ratio value to set. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | discrete | 1 - 2 | Channel number; when omitted, CH1 is used by default. |
| state | boolean | ON | 1 | OFF | 0 | Turns amplitude coupling 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.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | discrete | 1 - 2 | Specified channel number. |
| deviation | real | -99.999 999 999 9 MHz - 99.999 999 999 9 MHz | Frequency 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).
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 2 | Channel number to select the specified source. |
| mode | enum | OFFSet | RATio | Frequency coupling mode to use. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | discrete | 1 - 2 | Channel number; when omitted, CH1 is used by default. |
| value | real | 0.000 001 - 1 000 000 | Frequency ratio value. |
| qualifieropt | enum | MINimum | MAXimum | Literal keyword alternative to the numeric value. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Specifies the channel number; when omitted, CH1 is used by default. |
| state | enum | ON | 1 | OFF | 0 | Enables or disables frequency coupling. |
Sets the phase deviation in the phase coupling of the specified channel. Queries the phase deviation in the phase coupling of the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | integer | 1 - 2 | Specifies the channel; if omitted, CH1 is used by default. |
| deviation | real | -360° - 360° | Sets 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.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Specifies the channel number; when omitted, CH1 is used by default. |
| mode | enum | OFFSet | RATio | Selects phase deviation or phase ratio 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.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Specifies the channel number; if omitted, CH1 is used by default. |
| <value> | real | 0.01 - 100 | Sets the phase ratio. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum allowed phase ratio. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Specifies the channel number; when omitted, CH1 is used by default. |
| state | boolean | ON | 1 | OFF | 0 | Turns the phase coupling function on or off. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| <n>opt | discrete | 1 - 2 | Channel number to target; omitted value defaults to CH1. |
| state | enum | ON | 1 | OFF | 0 | Turns the coupling state on or 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.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | discrete | 1 - 2 | Specifies the channel number; when omitted, CH1 is used by default. |
| state | enum | ON | 1 | OFF | 0 | Turns trigger coupling on or off. |
:COUP1:TRI ON :COUP1:TRI?
Sets the screen brightness. Queries the screen brightness.
| Name | Type | Values | Description |
|---|---|---|---|
| brightness | integer | 1% - 100% | Screen brightness level. |
| qualifieropt | enum | MINimum | MAXimum | Optional query qualifier. |
:DISP:BRIG 51 :DISP:BRIG?
Enables the screen saver immediately without waiting.
Enables or disables the screen saver function. The query returns the current on/off status of the screen saver function.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | Sets the screen saver function state. |
:DISP:SAV OFF :DISP:SAV? :DISP:SAV 1 :DISP:SAV?
Queries the image of the front panel screen (screenshot).
Sets or queries the format of the returned screenshot image. The format can be BMP or PNG.
| Name | Type | Values | Description |
|---|---|---|---|
| format | enum | BMP | PNG | Image format for the screenshot return data. |
:HCOP:SDUM:DATA:FORM BMP :HCOP:SDUM:DATA:FORM?
Clears the event registers in all the register sets and clears the error queue.
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.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | - | Decimal value corresponding to the binary-weighted sum of the bits to be reported to the status byte register. |
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.
Queries the ID string of the instrument.
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.
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.
| Name | Type | Values | Description |
|---|---|---|---|
| {0|1} | enum | 0 | 1 | Clears or does not clear the status byte enable register and standard event enable register at power-on. |
*PSC 1 *PSC?
Recalls the state file stored in the specified internal non-volatile memory location.
| Name | Type | Values | Description |
|---|---|---|---|
| location | discrete | 0 | 1 | 2 | 3 | 4 | 5 | Specifies the storage location number of the state file to recall. |
Restores the instrument to its factory default state.
Stores the current instrument state in the specified storage location of the internal non-volatile memory with the default name.
| Name | Type | Values | Description |
|---|---|---|---|
| {0|1|2|3|4|5} | discrete | 0 - 5 | Storage location number for the instrument state file. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | - | Decimal value corresponding to the binary-weighted sum of the bits enabled in the status byte register. |
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.
Triggers a sweep or a burst.
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.
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.
Deletes the state file stored in the specified location of the instrument's internal non-volatile memory.
| Name | Type | Values | Description |
|---|---|---|---|
| location | enum | 0 | 1 | 2 | 3 | 4 | 5 | Storage 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.
| Name | Type | Values | Description |
|---|---|---|---|
| location | discrete | 0 - 5 | Storage location of the state file. |
| nameopt | string | - | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | Selects last configuration recall at power-on or factory default recall at 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.
| Name | Type | Values | Description |
|---|---|---|---|
| location | discrete | 0 - 5 | Storage location index for the state file. |
Queries all the files and folders in the current directory.
| Name | Type | Values | Description |
|---|---|---|---|
| folderopt | string | - | Valid directory in the internal or external memory; a string enclosed by double quotation marks. |
Queries the arbitrary waveform file and sequence file (*.RAF) under the current operation directory.
| Name | Type | Values | Description |
|---|---|---|---|
| folderopt | string | - | A valid directory in the internal or external memory, enclosed by double quotation marks. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| folderopt | string | - | Valid directory in the internal or external memory, enclosed by double quotation marks. |
:MMEMory:CATalog:STATe? [<folder>]
Sets the current directory. Queries the current directory.
| Name | Type | Values | Description |
|---|---|---|---|
| directory_name | string | Valid directory | Valid directory in the internal or external memory, 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:".*/
Copies a file from the current directory to a specified directory. The destination must be a directory other than the current directory.
| Name | Type | Values | Description |
|---|---|---|---|
| directory_name | string | - | Destination directory for the copied file. |
| file_name | string | - | Filename of the file under the current directory to copy. |
Deletes the specified file or empty folder from the current directory.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| binary_block | string | - | Binary data to load into the currently created file. |
Loads the specified state file or arbitrary waveform file under the current path.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 2 | Specifies CH1 or CH2 as the destination channel. |
| file_name | string | - | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| dir_name | string | - | 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.*/
Moves file 1 from the current directory to path 2.
| Name | Type | Values | Description |
|---|---|---|---|
| file1 | string | - | The file in the current directory; a string enclosed by double quotation marks. |
| file2 | string | - | 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.
Deletes the specified directory (empty folder) in the current path.
| Name | Type | Values | Description |
|---|---|---|---|
| folder | string | - | 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).
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | discrete | 1 | 2 | Specifies the channel whose arbitrary waveform or sequence data is stored. |
| file_name | string | - | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Selects the channel number; if omitted, CH1 is used by default. |
| ohms | integer | 1 Ω - 10 kΩ | Sets the output impedance to a specified value within the available range. |
| qualifieropt | enum | MINimum | MAXimum | Optional query qualifier that returns the minimum or maximum output impedance. |
Sets the output impedance/load of the specified channel, or queries the current value. The value may be a resistance, INFinity, MINimum, or MAXimum.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Specifies the channel number; if omitted, CH1 is used by default. |
| <ohms> | integer | 1 Ω - 10 kΩ | Sets the output impedance to the specified resistance value. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum allowed impedance value. |
Sets the output polarity of the specified channel to normal or inverted. Queries the output polarity of the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Specifies the channel number; when omitted, CH1 is used by default. |
| mode | enum | NORMal | INVerted | Sets the output polarity to normal or inverted. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Channel number; when omitted, CH1 is used by default. |
| state | boolean | ON | 1 | OFF | 0 | Sets the output state to on or off. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | integer | 1 - 2 | Specifies the output channel number; if omitted, CH1 is used by default. |
| polarity | enum | POSitive | NEGative | Sets 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.
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.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Selects the output channel. |
| amp | real | V | High level amplitude of the voltage limit. |
:OUTP1:VOLLimit:HIGH 1 :OUTP1:VOLLimit:HIGH?
Sets the low level amplitude of the voltage limit. Queries the low level limit value.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Selects the channel; when omitted, CH1 is used by default. |
| amp | real | V | Low level amplitude of the voltage limit. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | integer | 1 - 2 | Selects the channel; when omitted, CH1 is used by default. |
| state | boolean | ON | 1 | OFF | 0 | Turns the voltage limit 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).
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | INTernal | EXTernal | Selects the system clock source. |
:ROSC:SOUR INT /*Sets the system clock source to Internal.*/
Queries the currently selected system clock source.
:ROSC:SOUR:CURR? /*Queries the currently selected system clock source and the query returns INT.*/
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.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Source channel number; if omitted, CH1 is used by default. |
: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".*/
Sets or queries the burst mode for the specified channel. The burst type can be N cycle, Infinite, or Gated.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>opt | discrete | 1 - 2 | Channel number; if omitted, CH1 is used by default. |
| mode | enum | TRIGgered | INFinity | GATed | Selects the burst type. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | integer | 1 - 2 | Channel number. |
| frequency | real | Hz | Center frequency to set. |
| qualifieropt | enum | MINimum | MAXimum | Returns the minimum or maximum center frequency. |
:SOUR1:FREQ:CENT 500 :SOUR1:FREQ:CENT?
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.
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.
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.
| Name | Type | Values | Description |
|---|---|---|---|
| <n>opt | discrete | 1 - 2 | Source channel number. |
| <frequency> | real | Hz | Marker frequency to set. |
| qualifieropt | enum | MINimum | MAXimum | Returns the minimum or maximum allowed marker frequency. |
[:SOURce[<n>]]:MARKer:FREQuency {<frequency>|MINimum|MAXimum}
[:SOURce[<n>]]:MARKer:FREQuency? [MINimum|MAXimum]
:SOUR1:MARK:FREQ 500
:SOUR1:MARK:FREQ?Sets the AM modulation source of the specified channel to internal or external modulation source. Queries the AM modulation source of the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Specifies the channel number. |
| source | enum | INTernal | EXTernal | Selects 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.
Sets or queries the FM frequency deviation of the specified channel. The query returns the deviation in scientific notation with 7 effective digits.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>] | discrete | 1 - 2 | Channel number. |
| deviation | real | - | FM frequency deviation. |
| qualifieropt | enum | MINimum | MAXimum | Returns the minimum or maximum deviation. |
[: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.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>] | discrete | 1 - 2 | |
| frequency | real | Hz | Frequency range of the specified channel. |
| qualifieropt | enum | MINimum | MAXimum | Optional query qualifier for requesting the minimum or maximum frequency. |
Sets or queries the PM phase deviation of the specified channel. When omitted, CH1 is used by default.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Specifies the channel number. |
| deviation | real | 0° - 360° | Sets the PM phase deviation. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum phase deviation for the query. |
[: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.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>] | discrete | 1 - 2 | Specifies the channel number. |
| state | boolean | ON | 1 | OFF | 0 | Turns PSK modulation on or off. |
:SOUR1:PSK:STAT ON :SOUR1:PSK:STAT?
Sets or queries the PWM modulation function of the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>] | discrete | 1 - 2 | Channel number. |
| state | enum | ON | 1 | OFF | 0 | Enables or disables PWM modulation. |
: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.*/
Enables or disables the modulation function of the specified channel. Queries the on/off status of the modulation function of the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Specifies the channel number. |
| state | enum | ON | 1 | OFF | 0 | Enables 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.*/
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.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 | 2 | Specifies the channel number. |
| period | real | - | Sets the waveform period. |
: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.*/
Sets the waveform start phase of the specified channel. The query returns the waveform start phase in scientific notation with 7 effective digits.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Specifies the channel number; when omitted, CH1 is used by default. |
| phase | real | 0° - 360° | Sets the start phase. |
| qualifieropt | enum | MINimum | MAXimum | Optional query qualifier to return the minimum or maximum start phase. |
: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.*/
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.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Channel number to which the pulse settings apply. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Specifies the channel number. |
| state | enum | ON | 1 | OFF | 0 | Turns waveform combine on or off. |
[:SOURce[<n>]]:SUM[:STATe] {ON|1|OFF|0}
[:SOURce[<n>]]:SUM[:STATe]?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.
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.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | discrete | 1 - 2 | Selects the source channel; if omitted, CH1 is used by default. |
| flag | string | - | Data transmission status flag; can be CON or END. |
| data | block | 16Bytes - 32kBytes | Binary waveform data to be downloaded. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Specifies the channel number; when omitted, CH1 is used by default. |
| state | enum | ON | OFF | INVerted | Sets the track function state. |
: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.*/
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.
| Name | Type | Values | Description |
|---|---|---|---|
| <n>opt | discrete | 1 - 2 | Selects the channel number. |
| <amplitude> | real | 2 mVpp | Sets the waveform amplitude of the specified channel. |
| qualifieropt | enum | MINimum | MAXimum | For the query, returns the minimum or maximum amplitude. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | Sets 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.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | CH1 | CH2 |
Queries the number of output channels of the instrument.
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| integer | integer | 0 - 30 | GPIB address to set. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | Sets the AutoIP configuration mode on or off. |
: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.
Enables or disables the DHCP configuration mode. The query returns the current DHCP status.
| Name | Type | Values | Description |
|---|---|---|---|
| stateopt | enum | ON | 1 | OFF | 0 | Enables or disables DHCP configuration mode. |