The instrument will select a proper gate time automatically according to the characteristics of the signal under test after sending this command.
SCPI COMMAND REFERENCE
The Rigol DG832 is Rigol's function/arbitrary waveform generator in the DG800 Series family. Its SCPI remote-control interface exposes 134 commands across 13 subsystems - 114 settable and 20 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.
134
Commands
114
Settable
20
Queries
13
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 |
|---|---|---|---|
| mode | enum | AC | DC | Coupling mode for the input signal. |
:COUN:COUP DC :COUN:COUP?
Selects the gate time of the measurement system. The gate time can be set to one of USER1 through USER6; the query returns the current gate time setting.
| Name | Type | Values | Description |
|---|---|---|---|
| gate time | enum | USER1 | USER2 | USER3 | USER4 | USER5 | USER6 | Selects the gate time setting. |
Enables or disables the high frequency rejection function of the frequency counter. Queries the on/off status of the high frequency rejection function of the frequency counter.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | High frequency rejection state. |
: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 | Sets the trigger level to the minimum or maximum available value. |
Queries the measurement results of the frequency counter.
Sets the trigger sensitivity of the frequency counter. The query form returns the trigger sensitivity.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | LOW | HIGh | Trigger sensitivity setting for the frequency counter. |
Sets the status of the frequency counter. Queries the current operating status of the frequency counter.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | RUN | STOP | SINGLE | Enables or disables the frequency counter function, or sets its running status to run, stop, or single. |
:COUN OFF
Clears the statistics results.
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 |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | Enables or disables the statistical function. |
:COUN:STATI ON /*Enables the statistical function of the measurement results of the frequency :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, or queries the current amplitude deviation. When <n> is omitted, CH1 is used by default.
| Name | Type | Values | Description |
|---|---|---|---|
| <n>opt | discrete | 1 - 2 | Selects the channel number. |
| deviation | real | -19.998 - 19.998 | Sets the amplitude deviation. |
:COUP1:AMPL:DEV 1 :COUP1:AMPL:DEV?
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 |
|---|---|---|---|
| nopt | discrete | 1 - 2 | Channel number; when omitted, CH1 is used by default. |
| mode | enum | OFFSet | RATio | Amplitude coupling mode. |
Sets or queries the amplitude ratio in the amplitude coupling of the specified channel. The query returns the amplitude ratio in scientific notation with 7 effective digits.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Selects the channel number; when omitted, CH1 is used by default. |
| value | real | 0.001 - 1000 | Sets the amplitude ratio. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum amplitude ratio instead of a numeric value. |
: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 |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Specified channel number; when omitted, CH1 is used by default. |
| state | boolean | ON | 1 | OFF | 0 | Turns the amplitude coupling function on or off. |
:COUP1:AMPL ON /*Enables the amplitude coupling function of CH1.*/ :COUP1:AMPL? /*Queries the on/off status of the amplitude coupling function and the query returns ON.*/
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 | |
| deviation | real | -99.999 999 999 9 MHz - 99.999 999 999 9 MHz |
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; when omitted, CH1 is used by default. |
| mode | enum | OFFSet | RATio | Frequency coupling mode to select. |
:COUP1:FREQ:DEV 100 /*Set the frequency deviation in the frequency coupling of CH1 to 100 Hz.*/ :COUP1:FREQ:DEV? /*Queries the frequency deviation in the frequency coupling of CH1 and the query returns 1.000000E+02.*/
Sets or queries the frequency ratio in the frequency coupling of the specified channel. When queried, it returns the ratio in scientific notation with 7 effective digits.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Specifies the channel number; if omitted, CH1 is used by default. |
| <value> | real | 0.000 001 - 1 000 000 | Sets the frequency ratio. |
:COUP1:FREQ:RAT 100.123 :COUP1:FREQ:RAT?
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 | Channel number; when omitted, CH1 is used by default. |
| state | enum | ON | 1 | OFF | 0 | Turns the frequency coupling function on or off. |
Sets or queries the phase deviation in the phase coupling of the specified channel. When [<n>] is omitted, CH1 is used by default.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | integer | 1 - 2 | Specifies the channel number. |
| deviation | real | -360° - 360° | Sets the phase deviation. |
:COUPl1:PHASe:DEViation <deviation> :COUPl1:PHASe:DEViation?
Sets or queries the phase coupling mode of the specified channel. OFFSet selects phase deviation mode and RATio selects phase ratio mode.
| Name | Type | Values | Description |
|---|---|---|---|
| <n>opt | discrete | 1 - 2 | Specifies the channel number. |
| mode | enum | OFFSet | RATio | Selects phase deviation or phase ratio mode. |
:COUP1:PHAS:MODE OFFS :COUP1:PHAS:MODE?
Sets or queries the phase ratio in the phase coupling of the specified channel. When omitted, <n> defaults to CH1. The query returns the phase ratio in scientific notation with 7 effective digits.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | discrete | 1 - 2 | Specifies the channel number. |
| value | real | 0.01 - 100 | Phase ratio to set. |
| qualifieropt | enum | MINimum | MAXimum | Allows querying 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 | Enables or disables phase coupling. |
: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. Queries the on/off status of those three coupling functions for the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| <n>opt | discrete | 1 - 2 | Channel number; when omitted, CH1 is selected by default. |
| state | boolean | ON | 1 | OFF | 0 | Enables or disables coupling for the specified channel. |
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 /*Enables the trigger coupling function of CH1.*/ :COUP1:TRI? /*Queries the on/off status of the trigger coupling function of CH1 and the query returns ON.*/
Sets the screen brightness. The query returns the screen brightness in scientific notation.
| 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 on/off status of the screen saver function.
| Name | Type | Values | Description |
|---|---|---|---|
| stateopt | enum | ON | 1 | OFF | 0 | Enables or disables the screen saver function. |
:DISP:SAV OFF /*Disables the screen saver function.*/ :DISP:SAV? /*Queries the on/off status of the screen saver function and the query returns OFF.*/ :DISP:SAV 1 /*Enables the screen saver function.*/ :DISP:SAV? /*Queries the on/off status of the screen saver function and the query returns ON.*/
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 | Selects the screenshot image format. |
:HCOP:SDUM:DATA:FORM BMP :HCOP:SDUM:DATA:FORM?
Clears the event registers in all the register sets and clears the error queue.
Enables bits in the standard event register to be reported to the status byte register. The query returns the bits 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 in the standard event register. |
Queries the event register of the standard event register. The event register is read-only and is cleared when you query it.
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 completed.
Queries the installation state of the option. Different options are separated by a comma; installed options are returned by name, and uninstalled options are returned as 0.
*OPT? /*Queries the installation state of the option. The query returns 0,DCH.*/
Enables or disables clearing of the status byte enable register and standard event enable register at power-on. The query checks whether that clearing is enabled.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | 0 | 1 | Selects whether the status byte enable register and standard event enable register are cleared at power-on. |
*PSC 1 *PSC?
Recalls the state file stored in the specified location of the internal non-volatile memory.
| Name | Type | Values | Description |
|---|---|---|---|
| {0|1|2|3|4|5} | enum | 0 | 1 | 2 | 3 | 4 | 5 | Specifies which of the six internal storage locations to recall from. |
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} | enum | 0 | 1 | 2 | 3 | 4 | 5 | Specifies the internal storage location for the instrument state. |
*SAV 1
Enables the bits in the status byte register to generate the service request. Queries 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. |
Queries the status register of the status byte register. The query returns a decimal value corresponding to the binary-weighted sum of all the bits in the status register of the status byte register.
Triggers a sweep or a burst. It can only be used from the remote interface when the sweep or burst function is enabled and the trigger source is set to manual.
Executes any other command via the interface after all the pending operations are completed. This command is only applicable to triggered sweep mode or triggered burst mode, and is used to ensure synchronization.
Clears the installed option license.
| Name | Type | Values | Description |
|---|---|---|---|
| optionopt | enum | DCH | ARB | ALL | Selects which option license to clear. |
:LICense:CLEAR DCH /*Deletes the single-dual channel upgrade option.*/
Installs the option license. The license is a 28-byte ASCII string containing uppercase English letters and numbers, with hyphens omitted.
| Name | Type | Values | Description |
|---|---|---|---|
| license | string | - | Option license key to install. |
:LICense:INSTall 0A485CC695F5A7EC1116D598FF5F4DFFF7D3359266C6A400DA3DE9A5EE6F58758BC25E0FA8CAC3D115 D3267C419A3496E80629FAA2E344B1285BB
Installs the specified option license. The license string is 28 bytes and may include uppercase English letters and numbers; hyphens are omitted.
| Name | Type | Values | Description |
|---|---|---|---|
| license | string | - | Option license to install. |
:LICense:INSTall
Queries the installation state of the option.
:LIC? /*Queries the installation state of the option. The query returns 0,DCH.*/
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 internal non-volatile memory of the instrument.
Deletes the state file stored in the specified location of the internal non-volatile memory of the instrument.
| Name | Type | Values | Description |
|---|---|---|---|
| location | enum | 0 | 1 | 2 | 3 | 4 | 5 | Storage location of the state file to delete. |
:MEM:STAT:DEL 1 /*Deletes the state file stored in location 1 of the internal non-volatile memory of the instrument.*/
Modifies the filename of the state file stored in the specified internal non-volatile memory location. The query returns the filename of the state file in that location as a quoted string.
| Name | Type | Values | Description |
|---|---|---|---|
| location | integer | 0 - 5 | Storage location index for the state file. |
| nameopt | string | - | Specified filename; if omitted, the filename is empty. |
:MEM:STAT:NAME 2,123 /*Modifies the filename of the state file stored in storage location 2 of the internal non-volatile memory of the instrument to 123.RSF.*/
Recalls the configuration of the instrument to last or default at next power-on. Queries the configuration of the instrument at next power-on.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | Selects whether the instrument recalls the last system configuration or factory defaults at 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 instrument's internal non-volatile memory.
| Name | Type | Values | Description |
|---|---|---|---|
| location | integer | 0 - 5 | Storage location index for the state file. |
Queries all the files and folders in the current directory. An optional folder path may be supplied to query a specific directory.
| Name | Type | Values | Description |
|---|---|---|---|
| folderopt | string | - | Valid directory in the internal or external memory, enclosed in double quotation marks. |
Queries the arbitrary waveform file and sequence file (*.RAF) under the current operation directory.
| Name | Type | Values | Description |
|---|---|---|---|
| <folder>opt | string | - | Valid directory in the internal or external memory. |
: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 or queries the current directory.
| Name | Type | Values | Description |
|---|---|---|---|
| directory_name | string | - | The directory to set as the current directory; must be a valid directory in internal or external memory and be enclosed in 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.
| Name | Type | Values | Description |
|---|---|---|---|
| directory_name | string | - | Destination directory; must be a valid directory. |
| file_name | string | - | Name of the file under the current directory to copy. |
:MMEMory:COPY <directory_name>,<file_name>
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. |
]0;?
Creates a file under the current directory.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | Filename for the file to be created under the current directory. |
Assume that the current directory is C:\. :MMEMory:DOWNload:FNAMe <file_name>
Loads binary data into the currently created file.
| Name | Type | Values | Description |
|---|---|---|---|
| binary_block | block | - | Binary data to load into the current file. |
:MMEMory:DOWNload:DATA <binary_block>
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 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 number is omitted, the file is loaded into CH1 by default.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | discrete | 1 - 2 | Selects CH1 or CH2 as the destination channel. |
| file_name | string | - | Filename of the arbitrary waveform file or 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 a specified name. This command is only applicable to the external memory.
| Name | Type | Values | Description |
|---|---|---|---|
| dir_name | string | - | The name of the folder to be created; it must be enclosed in double quotation marks and cannot exceed 7 characters. |
: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. |
| file2 | string | - | A valid directory in the internal or external memory. |
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 empty directory 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 in state file or arbitrary waveform file form with the specified name.
| 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 arbitrary waveform or sequence data of the specified channel into the current directory as an arbitrary waveform file (*.RAF) or sequence file. The filename is specified in double quotes and may include the .RAF suffix.
| 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, 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's output connector.
| Name | Type | Values | Description |
|---|---|---|---|
| <n>opt | discrete | 1 - 2 | Specifies the channel number; when 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 | Query qualifier that returns the minimum or maximum output impedance. |
Sets or queries the output load impedance of the specified channel. A value of INFinity sets the output to HighZ.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | discrete | 1 - 2 | Channel number; when omitted, CH1 is used by default. |
| ohms | integer | 1 Ω - 10 kΩ | Specified load impedance value. |
| qualifieropt | enum | MINimum | MAXimum | Query qualifier that returns the minimum or maximum load impedance. |
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 output channel number; if 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 to control; if omitted, CH1 is used by default. |
| state | boolean | ON | 1 | OFF | 0 | Output enable/disable state. |
Sets or queries the polarity of the sync signal on the rear-panel [Sync/Ext Mod/Trig/FSK] connector for the specified channel. POSitive means normal output and NEGative means inverted output.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Specifies the channel number; if omitted, CH1 is used by default. |
| polarity | enum | POSitive | NEGative | Sets the sync output 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.
| Name | Type | Values | Description |
|---|---|---|---|
| <n>opt | discrete | 1 - 2 | Specified channel number. |
| state | enum | ON | 1 | OFF | 0 | Enables or disables the sync signal output. |
Sets the high level amplitude of the voltage limit, or queries the current high level limit value. When <n> is omitted, CH1 is used by default.
| Name | Type | Values | Description |
|---|---|---|---|
| <n>opt | discrete | 1 - 2 | Channel number. |
| amp | real | V | High level limit amplitude. |
:OUTP1:VOLLimit:HIGH 1 :OUTP1:VOLLimit:HIGH?
Sets the low level amplitude of the voltage limit, and queries the low level limit value. When [<n>] is omitted, CH1 is used by default.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Channel number to target. |
| 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 | discrete | 1 - 2 | Selects the output 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 the waveform of the specified channel and its main signal parameters. The command has waveform-specific forms such as DC, Dual-tone, Harmonic, Noise, PRBS, Pulse, Ramp, RS232, Sequence, Sine, Square, and User, and the query form returns the current waveform type and parameters.
Sets or queries the burst settings of the specified channel. The slice documents the burst subcommands and shows that omitted channel number defaults to CH1.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Channel number to apply the burst settings to. |
:SOUR1:APPL:USER 100,1,2,3 /*Sets the waveform of CH1 to Arbitrary with 100 Hz frequency, 1 Vpp notes":"The manual page is a command-group overview; it does not document a specific parameter set for :SOURce:BURSt itself beyond the shared channel selector and the listed subcommands."}]}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]```}]}]}]}]}]}]]}]}]}]}`ા}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}}}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}}}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}}}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}]}
Sets the frequency of the specified source. In sweep mode, this command sets the center frequency of the sweep function.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Specifies the channel number. |
| frequency | real | - | Frequency value to set. |
Sets or queries the waveform function of the specified channel. When the source channel is omitted, CH1 is used by default.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Specifies the source channel number. |
Enables or disables the harmonic function of the specified channel, and queries its on/off status. When the source node is omitted, CH1 is used by default.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 | 2 | Selects the output channel. |
| state | boolean | ON | 1 | OFF | 0 | Enables or disables the harmonic function. |
:SOUR1:HARM ON /*Enables the harmonic function of CH1.*/ :SOUR1:HARM? /*Queries the on/off status of the harmonic function of CH1 and the query returns ON.*/
Sets or queries the marker frequency of the specified channel. When omitted, the channel defaults to CH1.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 | 2 | Specifies the source channel number. |
| <frequency> | real | Hz | Sets the marker frequency; the allowed range is limited by the start and stop frequencies. |
:SOUR1:MARK:FREQ 500 /*Sets the marker frequency of CH1 to 500 Hz.*/ :SOUR1:MARK:FREQ? /*Queries the marker frequency of CH1 and the query returns 5.000000E+02.*/
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 | - | |
| source | enum | INTernal | EXTernal | Selects whether AM modulation uses the internal or external source. |
ASK modulation commands for the specified source/channel. This parent mnemonic groups the ASK amplitude, internal rate, polarity, source, and state subcommands.
Sets or queries the FM frequency deviation of the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>] | discrete | 1 - 2 | Specifies the channel number. |
| deviation | real | - | FM frequency deviation. |
| qualifieropt | enum | MINimum | MAXimum | Returns the minimum or maximum deviation when used with the query. |
:SOUR1:FM 100 :SOUR1:FM?
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 | - | Frequency range of the specified channel. |
| qualifieropt | enum | MINimum | MAXimum | Optional keyword to request the minimum or maximum frequency. |
:SOUR1:FSK 5000 /*Sets the FSK hop frequency of CH1 to 5 kHz.*/ :SOUR1:FSK? /*Queries the FSK hop frequency of CH1 and the query returns 5.000000E+03.*/
Sets or queries the PM phase deviation of the specified channel. The query returns the PM phase deviation in scientific notation with 7 effective digits.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Channel number. |
| deviation | real | 0° - 360° | PM phase deviation. |
| qualifieropt | enum | MINimum | MAXimum | Returns the minimum or maximum PM phase deviation. |
[:SOURce[<n>]][:MOD]:PM[:DEViation] {<deviation>|MINimum|MAXimum}
[:SOURce[<n>]][:MOD]:PM[:DEViation]? [MINimum|MAXimum]
:SOUR1:PM 50
:SOUR1:PM?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>]opt | discrete | 1 - 2 | |
| state | enum | ON | 1 | OFF | 0 | Enables or disables the PSK modulation function. |
:SOUR1:PSK:STAT ON :SOUR1:PSK:STAT?
Sets or queries the PWM modulation subsystem for the specified channel. The slice documents related subcommands for duty cycle deviation, width deviation, internal frequency/function, source, and on/off state.
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 |
|---|---|---|---|
| nopt | integer | 1 - 2 | Channel number to apply the command to. |
| state | enum | ON | 1 | OFF | 0 | Turns modulation on or off. |
::SOUR1:MOD ON ::SOUR1:MOD?
Sets or queries the waveform period of the specified channel for basic and arbitrary waveforms. If omitted, the channel defaults to CH1; invalid periods are clamped to the waveform's period lower limit.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Specifies the channel number. |
| <period> | real | - | Sets the waveform period. |
[:SOURce[<n>]]:PERiod[:FIXed] {<period>|MINimum|MAXimum}
[:SOURce[<n>]]:PERiod[:FIXed]? [MINimum|MAXimum]
: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 waveform start phase. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum start phase value. |
: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 or queries the pulse duty cycle of the specified channel. The query returns the duty cycle in scientific notation with 7 effective digits.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Specifies the channel number. |
| percent | real | 0.001% - 99.999% | Pulse duty cycle value. |
| qualifieropt | enum | MINimum | MAXimum | Optional keyword to use the minimum or maximum allowed value. |
::SOUR1:PULS:DCYC 45 ::SOUR1:PULS:DCYC?
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]?Sets or queries the sweep function of the specified channel. The page slice documents the sweep subsystem and lists related child commands such as sweep time, spacing, state, and trigger settings.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Channel number; when omitted, CH1 is used by default. |
Downloads a waveform table to the DDRIII internal memory. The command takes a binary data block and uses the <flag> field to indicate whether more data packages follow or the transmission ends.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Selects the source channel; if omitted, the instrument uses CH1 by default. |
| <flag> | string | - | Indicates the data transmission status; CON means more data packages follow, and END means this is the last package. |
| <data> | block | - | Binary data block to be downloaded. The data length ranges from 8 pts (16 bytes) to 16 kpts (32 kbytes). |
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. |
| 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 amplitude of the specified channel. The query accepts optional MINimum or MAXimum qualifiers.
| Name | Type | Values | Description |
|---|---|---|---|
| <n>opt | discrete | 1 - 2 | Specified channel number. |
| amplitude | real | - | Waveform amplitude to set. |
| qualifieropt | enum | MINimum | MAXimum | Queries the minimum or maximum amplitude when used with the query form. |
: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; the beeper will sound even if it is disabled.
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 state. |
: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 |
|---|---|---|---|
| channel | enum | CH1 | CH2 | Current channel selection. |
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 GPIB address of the instrument. 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 settings only take effect after this command is executed.
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 whether AutoIP configuration mode is enabled or disabled. |
*No exact example for the full long-form mnemonic is printed; the manual shows :SYST:COMM:LAN:AUTO OFF and :SYST:COMM:LAN:AUTO?.
Reads the port number of the initial control connecting port for socket communication.
Enables or disables the DHCP configuration mode. The query checks the status of the DHCP configuration mode.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | Enables or disables DHCP configuration mode. |
:SYST:COMM:LAN:DHCP OFF /*Disables the DHCP configuration mode.*/ :SYST:COMM:LAN:DHCP? /*Queries the status of the DHCP configuration mode and the query returns OFF.*/
Sets the DNS address. Queries the DNS address.
| Name | Type | Values | Description |
|---|---|---|---|
| address | string | - | DNS server address. |
Sets the default gateway. Queries the default gateway.
| Name | Type | Values | Description |
|---|---|---|---|
| address | string | - | Default gateway address in the form nnn.nnn.nnn.nnn. |
*:SYST:COMM:LAN:GATE 192.168.1.1 *:SYST:COMM:LAN:GATE?
Sets the IP address. Queries the IP address.
| Name | Type | Values | Description |
|---|---|---|---|
| ip_address | string | 1 - 223 | IP address in the format nnn.nnn.nnn.nnn; first segment must be 1 to 223 except 127, and the other three segments 0 to 255. |
:SYST:COMM:LAN:IPAD 192.168.1.88 /*Sets the IP address to 192.168.1.88.*/ :SYST:COMM:LAN:IPAD? /*Queries the IP address and the query returns 192.168.1.88.*/
Sets the subnet mask. This command is only valid when ManualIP configuration mode is enabled, and the new setting takes effect only after :SYSTem:COMMunicate:LAN:APPLy is executed.
| Name | Type | Values | Description |
|---|---|---|---|
| mask | string | - | Subnet mask in the form nnn.nnn.nnn.nnn; each nnn ranges from 0 to 255 and the mask must be continuous. |
:SYST:COMM:LAN:SMAS 255.255.255.0
Enables or disables the manual IP configuration mode. Queries the status of the manual IP configuration mode.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | Enables or disables manual IP configuration mode. |
<missing>
Queries the USB information of the instrument.
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.
| Name | Type | Values | Description |
|---|---|---|---|
| name | enum | CH1 | CH2 | Source and destination channel names; the two values cannot be the same. |
[SYST:CSC CH1,CH2
Queries and clears an error message from the error queue.
Locks or unlocks the specified key or the knob. Also queries whether the specified key or the knob is locked or not.
| Name | Type | Values | Description |
|---|---|---|---|
| key | enum | <key> | The specified key or knob to lock or unlock. |
| state | enum | ON | 1 | OFF | 0 | Sets whether the specified key or knob is locked or unlocked. |
Sets the system language to English or Simplified Chinese. Queries the system language.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | ENGLish | SCHinese | Selects the 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.
| Name | Type | Values | Description |
|---|---|---|---|
| stateopt | enum | ON | 1 | OFF | 0 | Turns the system log on or off. |
:SYST:LOG 1 :SYST:LOG?
Sets the power-on state to Default (DEFault) or Last (LAST). Queries the power-on state.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | DEFault | LAST | Selects the power-on state. |
:SYST:POW LAST /*Sets the power-on state to Last.*/ :SYST:POW? /*Queries the power-on state and the query returns LAST.*/
Deletes the specified user-stored state file (USER1 to USER10) in the instrument's internal memory.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | USER1 | USER2 | USER3 | USER4 | USER5 | USER6 | USER7 | USER8 | USER9 | USER10 | Specifies which stored user 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.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | DEFault | USER1 | USER2 | USER3 | USER4 | USER5 | USER6 | USER7 | USER8 | USER9 | USER10 | Selects the default state or the user-stored state file to recall. |
:SYSTem:PRESet:RECall USER1
Saves the current system status to the specified user storage location in the internal memory of the instrument.
| Name | Type | Values | Description |
|---|---|---|---|
| location | enum | USER1 | USER2 | USER3 | USER4 | USER5 | USER6 | USER7 | USER8 | USER9 | USER10 | Specifies the user storage location to save the 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, with each saved user status name returned in its corresponding position.
Sets or queries the system clock source. The source can be internal or external.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | INTernal | EXTernal | System clock source to use. |
:SYST:ROSC:SOUR INT /*Sets the system clock source to Internal.*/ :SYST:ROSC:SOUR? /*Queries the system clock source type and the query returns INT.*/
Sets the burst delay of the specified channel. Queries the burst delay of the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| <n>opt | integer | 1 - 2 | |
| seconds | real | 0 s - 100 s | Burst delay value; range depends on burst mode and trigger source. |
| qualifieropt | enum | MINimum | MAXimum | Allows querying the minimum or maximum burst delay. |
Generates a trigger on the specified channel. When <n> is omitted, CH1 is used by default.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | discrete | 1 - 2 | Specifies the channel number. |
:TRIG1 /*Generates a trigger on CH1.*/
Sets the edge type of the trigger input signal of the specified channel to rising or falling edge. Queries the edge type of the trigger input signal of the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Specifies the channel number. |
| edge | enum | POSitive | NEGative | Selects the trigger input edge polarity. |
<none>
Sets or queries the trigger source of the specified channel. The source can be Internal, External, or Manual (BUS).
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Specifies the channel number; if omitted, CH1 is used by default. |
| source | enum | INTernal | EXTernal | BUS | Selects the trigger source. |
:TRIG1:SOUR INT /*Sets the trigger source of CH1 to Internal.*/ :TRIG1:SOUR? /*Queries the trigger source of CH1 and the query returns INT.*/