The instrument automatically selects a proper gate time according to the characteristics of the signal under test. It is related to :COUNter:GATEtime.
SCPI COMMAND REFERENCE
The Rigol DG1032Z is Rigol's function generator in the DG1000Z Series family. Its SCPI remote-control interface exposes 130 commands across 14 subsystems - 107 settable and 23 queries - and every command is documented here with its parameters, accepted values, return format, and a copy-paste PyVISA example for automating test and measurement.
130
Commands
107
Settable
23
Queries
14
Subsystems
SCPI
Verified
2026-07-16
All commands
Sets the coupling mode of the counter input signal to AC or DC. The query returns the current coupling mode.
| 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 available values are USER1 through USER6; the query returns the currently selected gate time or AUTO while automatic selection is in progress.
| Name | Type | Values | Description |
|---|---|---|---|
| gate time | enum | USER1 | USER2 | USER3 | USER4 | USER5 | USER6 | Selects the gate time setting. |
:COUN:GATE USER2 :COUN:GATE?
Enable or disable the high-frequency rejection function of the frequency counter. The query returns 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 :COUN:HF?
Sets or queries the trigger level of the frequency counter. The query returns the trigger level in scientific notation with 7 effective digits.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | -2.5V - 2.5V | Trigger level used when the frequency counter starts measuring as the input signal reaches this level. |
| qualifieropt | enum | MINimum | MAXimum | Optional keyword qualifier for the setter or query syntax. |
:COUN:LEVE 1.5 :COUN:LEVE?
Queries the measurement results of the frequency counter. When the counter is RUN, SINGLE, or STOP, it returns the current or last measurement values; when disabled, it returns zeros.
:COUN:MEAS? /*Query the measurement results of the frequency counter and the query returns 2.000000000E+03,5.000000000E-04, 4.760800000E+01,2.380415000E-04,2.619585000E-04*/
Sets or queries the trigger sensitivity of the frequency counter.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | 0% - 100% | Trigger sensitivity to set for the frequency counter. |
| qualifieropt | enum | MINimum | MAXimum | Optional query qualifier that returns the minimum or maximum trigger sensitivity. |
:COUN:SENS 30 :COUN:SENS?
Sets or queries the status of the frequency counter. The enabled state uses ON/OFF (or 1/0), and when enabled the running status can be RUN, STOP, or SINGLE.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | RUN | STOP | SINGLE | Sets the frequency counter function and, when enabled, its running status. |
:COUN OFF :COUN? :COUN 1 :COUN? :COUN STOP :COUN?
Clear the statistic results. This command is only valid when the frequency counter statistic function is enabled; results are cleared automatically when the function is disabled.
Sets the display format of the statistic results of the frequency counter measurement values to DIGITAL or CURVE. The query returns the current display format.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | DIGITAL | CURVE | Display format for the statistic results. |
:COUN:STATI:DISP CURVE :COUN:STATI:DISP?
Enable or disable the statistic function of the measurement values of the frequency counter. The query reports the on/off status of the statistic function.
| Name | Type | Values | Description |
|---|---|---|---|
| stateopt | enum | ON | 1 | OFF | 0 | Enables or disables the statistic function. |
:COUN:STATI ON :COUN:STATI?
Sets or queries the amplitude deviation in the amplitude coupling. The query returns the amplitude deviation in scientific notation with 7 effective digits.
| Name | Type | Values | Description |
|---|---|---|---|
| deviation | real | -19.998Vpp - 19.998Vpp | Amplitude deviation to set in the amplitude coupling. |
:COUP:AMPL:DEV 1 :COUP:AMPL:DEV?
Sets the amplitude coupling mode to amplitude deviation (OFFSet) or amplitude ratio (RATio). The query returns the selected amplitude coupling mode.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | OFFSet | RATio | Amplitude coupling mode. |
:COUP:AMPL:MODE OFFS :COUP:AMPL:MODE?
Sets the amplitude ratio in the amplitude coupling, or queries the current amplitude ratio. When queried, the command returns the ratio in scientific notation with 7 effective digits.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | 0.001 - 1000 | Amplitude ratio to set. |
| qualifieropt | enum | MINimum | MAXimum | Optional keyword to set the minimum or maximum amplitude ratio. |
:COUP:AMPL:RAT 1.123 :COUP:AMPL:RAT?
Enables or disables the amplitude coupling function. The query returns the on/off status of amplitude coupling.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | Sets the amplitude coupling function on or off. |
:COUP:AMPL ON :COUP:AMPL?
Sets the frequency deviation in the frequency coupling, or queries the current frequency deviation. The query returns the deviation in scientific notation with 7 effective digits.
| Name | Type | Values | Description |
|---|---|---|---|
| deviation | real | -59.999 999 999 999MHz - 59.999 999 999 999MHz | Frequency deviation to set in the frequency coupling. |
:COUP:FREQ:DEV 100 :COUP:FREQ:DEV?
Sets the frequency coupling mode to frequency deviation (OFFSet) or frequency ratio (RATio). The query returns the selected frequency coupling mode.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | OFFSet | RATio | Selects the frequency coupling mode. |
:COUP:FREQ:MODE OFFS :COUP:FREQ:MODE?
Sets or queries the frequency ratio in the frequency coupling.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | 0.000 001 - 1 000 000 | Frequency ratio value. |
:COUP:FREQ:RAT 100.123 :COUP:FREQ:RAT?
Enables or disables the frequency coupling function. The query returns the on/off status of the frequency coupling function.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | Turns frequency coupling on or off. |
:COUP:FREQ ON /*Enable the frequency coupling function*/ :COUP:FREQ? /*Query the on/off status of the frequency coupling function and the query returns ON*/
Sets or queries the phase deviation used in phase coupling. The deviation must be between -360° and 360°.
| Name | Type | Values | Description |
|---|---|---|---|
| deviation | real | -360° - 360° | Phase deviation value. |
:COUP:PHAS:DEV 90 :COUP:PHAS:DEV?
Sets the phase coupling mode to phase deviation (OFFSet) or phase ratio (RATio). The query returns the selected phase coupling mode.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | OFFSet | RATio | Selects the phase coupling mode. |
:COUP:PHAS:MODE OFFS /*Set the phase coupling mode to phase deviation*/ :COUP:PHAS:MODE? /*Query the phase coupling mode and the query returns OFFSET*/
Sets or queries the phase ratio in the phase coupling. The query returns the phase ratio in scientific notation with 7 effective digits.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | 0.01 - 100 | Phase ratio to set. |
:COUP:PHAS:RAT 1.12 /*Set the phase ratio in the phase coupling to 1.12*/ :COUP:PHAS:RAT? /*Query the phase ratio in the phase coupling and the query returns 1.120000E+00*/
Enables or disables the phase coupling function. The query returns the on/off status of phase coupling.
| Name | Type | Values | Description |
|---|---|---|---|
| state | boolean | ON | 1 | OFF | 0 | Turns phase coupling on or off. |
:COUP:PHAS ON /*Enable the phase coupling function*/ :COUP:PHAS? /*Query the on/off status of the phase coupling function and the query returns ON*/
Enables or disables frequency coupling, phase coupling, and amplitude coupling of the channel at the same time. The query returns the on/off states of the three coupling functions in order, separated by commas.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | Turns coupling on or off. |
:COUP ON :COUP?
Sets or queries the screen brightness. The query returns the screen brightness in scientific notation with 7 effective digits.
| Name | Type | Values | Description |
|---|---|---|---|
| brightness | integer | 1% - 100% | Screen brightness level. |
| qualifieropt | enum | MINimum | MAXimum | Optional query qualifier to request the minimum or maximum brightness value. |
:DISP:BRIG 51 :DISP:BRIG?
Sets the screen contrast or queries the current screen contrast. The query returns the contrast in scientific notation with 7 effective digits.
| Name | Type | Values | Description |
|---|---|---|---|
| contrast | integer | 1% - 100% | Screen contrast setting. |
| qualifieropt | enum | MINimum | MAXimum | Uses the minimum or maximum contrast value. |
:DISP:CONT 28 :DISP:CONT?
Queries the front-panel screen image (screenshot). The returned data is a definite-length binary block containing the image.
:DISPlay:DATA?
Sets the display mode to dual-channel parameters, dual-channel graph, or single-channel display mode. The query returns the current display mode.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | DPV | DGV | SV | Display mode to select. |
:DISP:MODE DGV :DISP:MODE?
Enables the screen saver immediately without waiting.
Enable or disable 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 :DISP:SAV? :DISP:SAV 1 :DISP:SAV?
Enable or disable the screen display. The display is automatically enabled when the instrument returns to local mode.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | Enables or disables the screen display. |
:DISP OFF :DISP? :DISP 1 :DISP?
Query the string currently displayed on the screen. The query returns the current screen text enclosed in double quotation marks.
:DISP:TEXT?
Clears the string currently displayed on the screen.
Displays the specified quoted string at the specified screen coordinates. If only one coordinate is supplied, it is treated as the horizontal x value; omitted coordinates use the last effective coordinate or the default coordinate after power-on.
| Name | Type | Values | Description |
|---|---|---|---|
| quoted string | string | - | String enclosed in double quotation marks to display on the screen, up to 45 characters. |
| xopt | integer | 2 - 319 | Horizontal coordinate of the upper-left corner of the displayed string. |
| yopt | integer | 2 - 239 | Vertical coordinate of the upper-left corner of the displayed string. |
:DISP:TEXT "RIGON",25,35
Queries the image displayed on the front panel screen (screenshot). The query returns a definite-length binary data block containing the image.
Sets or queries the format of the image returned by the screenshot operation. The manual slice documents only the BMP format.
| Name | Type | Values | Description |
|---|---|---|---|
| format | enum | BMP | Image format for the screenshot operation. |
:HCOP:SDUM:DATA:FORM BMP :HCOP:SDUM:DATA:FORM?
Clears the event registers of all register sets and the error queue.
Enables bits to be reported to the status byte register in the standard event register. The query returns the enabled bits as a decimal value.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | - | Decimal value corresponding to the sum of the binary weights of the bits to be reported to the status byte register in the standard event register. |
Queries the event register of the standard event register. The event register is read-only and is cleared when queried.
Queries the ID string of the instrument.
Sets the OPC (operation complete) bit in the standard event register after all previously sent commands have executed. The query checks whether all previously sent commands have executed and returns 1 if so.
*OPC *OPC?
Queries whether the 16M internal memory option (Arb 16M) has been installed.
*OPT?
Enables or disables clearing the status byte enable register and standard event enable register at power-on. The query reports the current power-on status clear setting.
| Name | Type | Values | Description |
|---|---|---|---|
| {0|1} | 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 (USER) or arbitrary waveform file (ARB) stored in the specified location in internal non-volatile memory.
| Name | Type | Values | Description |
|---|---|---|---|
| location | enum | USER1 | USER2 | USER3 | USER4 | USER5 | USER6 | USER7 | USER8 | USER9 | USER10 | ARB1 | ARB2 | ARB3 | ARB4 | ARB5 | ARB6 | ARB7 | ARB8 | ARB9 | ARB10 | Specifies the storage location to recall. |
Restores the instrument to its factory state. It stops any sweep or burst in progress abnormally and turns the display on if it was previously turned off.
Stores the current instrument state (USER) or arbitrary waveform data (ARB) in the specified internal non-volatile memory location with the default name.
| Name | Type | Values | Description |
|---|---|---|---|
| storage location | enum | USER1 | USER2 | USER3 | USER4 | USER5 | USER6 | USER7 | USER8 | USER9 | USER10 | ARB1 | ARB2 | ARB3 | ARB4 | ARB5 | ARB6 | ARB7 | ARB8 | ARB9 | ARB10 | Selects the storage location for the state or arbitrary waveform file. |
*SAV USER1
Enables bits in the status byte register to generate a service request. The query returns the decimal value corresponding to the sum of the binary weights of the bits enabled in the status byte register.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | - | Decimal value corresponding to the sum of the binary weights of the bits enabled in the status byte register. |
Queries the status register of the status byte register. This command cannot clear the service request; bit6 remains set while the service-request condition is still in effect.
Triggers a sweep or burst. It can only be used over the remote interface when sweep or burst is enabled and the trigger source is set to manual.
Execute any other command via the interface after all pending operations are completed. It is only applicable to triggered sweep mode or triggered burst mode and is used to ensure synchronization.
Install the 16M internal memory option (Arb 16M).
| Name | Type | Values | Description |
|---|---|---|---|
| sn | string | - | Option serial number string, 28 bytes long, containing uppercase English letters and numbers. |
Turns the LXI Identify indicator on the screen on or off. The query returns the current on/off status of the indicator.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | Sets the LXI Identify indicator state. |
:LXI:IDEN ON :LXI:IDEN?
Enable or disable the multiple DNS system (mDNS). The query returns the current mDNS status.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | Enables or disables the multiple DNS system. |
:LXI:MDNS:ENAB ON /*Enable the multiple DNS system*/ :LXI:MDNS:ENAB? /*Query the status of the multiple DNS system and the query returns ON*/
Queries the host name of the analyzed mDNS service.
Sets the mDNS service name, or queries the current mDNS service name. The name is stored in non-volatile memory and is reset to its default by :SYSTem:SECurity:IMMediate.
| Name | Type | Values | Description |
|---|---|---|---|
| name | string | - | Service name to assign to mDNS. |
:LXI:MDNS:SNAM:DES RIGOL1 /*Set the service name of mDNS to RIGOL1*/ LXI:MDNS:SNAM:DES? /*Query the service name of mDNS and the query returns RIGOL1*/
Queries the service name of analyzed mDNS service.
Reset the LAN setting to the known operation state, beginning from DHCP. If DHCP fails, AutoIP is used.
Restart the LAN according to the current setting. Several seconds are required for the LAN interface to restart after sending this command.
Queries the number of storage locations for state files in the instrument's internal non-volatile memory.
Queries the state files stored in the internal non-volatile memory of the instrument.
Deletes the state file stored in the specified internal non-volatile memory location. The command is valid only when the location contains a state file and the file is not locked.
| Name | Type | Values | Description |
|---|---|---|---|
| location | enum | USER1 | USER2 | USER3 | USER4 | USER5 | USER6 | USER7 | USER8 | USER9 | USER10 | Specifies which of the 10 internal state file storage locations to delete. |
:MEM:STAT:DEL USER1
Locks or unlocks the state file stored in the specified internal non-volatile memory storage location. The query checks whether the specified state file is locked.
| Name | Type | Values | Description |
|---|---|---|---|
| location | enum | USER1 | USER2 | USER3 | USER4 | USER5 | USER6 | USER7 | USER8 | USER9 | USER10 | Specifies the internal state file storage location. |
| state | enum | ON | 1 | OFF | 0 | Sets whether the selected state file is locked or unlocked. |
:MEM:STAT:LOCK USER1,ON :MEM:STAT:LOCK? USER1
Modifies or queries the filename of the state file stored in a specified internal non-volatile memory location. The location is selected by an index from 0 to 9, representing storage locations 1 to 10.
| Name | Type | Values | Description |
|---|---|---|---|
| location | discrete | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | Storage location index for the state file. |
| nameopt | string | - | Filename to assign to the state file; if omitted, the filename is empty. |
:MEM:STAT:NAME 1,123 :MEM:STAT:NAME? 1
Sets the instrument configuration to be used at the next power-on to the last-used settings or the factory default. The query reports which configuration will be used at the next power-on.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | Selects whether the next power-on uses the last instrument configuration or the default configuration. |
:MEM:STAT:RECall:AUTO ON /*Set the instrument configuration to be used at :MEM:STAT:RECall:AUTO? /*Query the instrument configuration to be used at
Queries whether the specified storage location in internal non-volatile memory contains a state file.
| Name | Type | Values | Description |
|---|---|---|---|
| location | enum | USER1 | USER2 | USER3 | USER4 | USER5 | USER6 | USER7 | USER8 | USER9 | USER10 | Storage location to check for a state file. |
Queries all the files and folders in the current directory. This command is only applicable to external memory.
| Name | Type | Values | Description |
|---|---|---|---|
| folderopt | string | - | Valid directory in the external memory, including the D disk and folders in the D disk. |
:MMEM:CAT? /*Query all the files and folders in the external memory and the query returns 28672,4102361088,"3,DIR,Rigol","80,,Rigol1.RAF","1360,,Rigol 0.RSF"*/
Queries the arbitrary waveform files in the current operation directory. This command is only applicable to external memory and accepts an optional folder path.
| Name | Type | Values | Description |
|---|---|---|---|
| folderopt | string | - | Valid directory in the external memory, enclosed in double quotation marks. |
Assume that the current directory is D:\, :MMEM:CAT:DATA:ARB? /*Query the arbitrary waveform file in the external memory directory and the query returns 28672,4102361088,"80,,Rigol1.RAF"*/
Queries the state file under the current operation directory in external memory. The query returns a string listing space used, space available, and any matching state files.
| Name | Type | Values | Description |
|---|---|---|---|
| folderopt | string | - | Valid directory in the external memory, such as "D:\" or a folder under the D disk. |
:MMEM:CAT:STAT? /*Query the state file in the external memory directory and the query returns 28672,4102361088,"1360,,Rigol0.RSF"*/
Sets the current directory in external memory, or queries the current directory. The directory must be a valid external-memory path such as "D:\" or a folder under the D disk.
| Name | Type | Values | Description |
|---|---|---|---|
| directory_name | string | - | Current directory path in external memory. |
:MMEM:CDIR "D:\" :MMEM:CDIR?
Copies a file from the current directory in external memory to a specified directory in external memory. This command is only applicable to external memory.
| Name | Type | Values | Description |
|---|---|---|---|
| directory_name | string | - | Target directory in the external memory. |
| file_name | string | - | Filename of the file under the current directory of the external memory. |
:MMEM:COPY "D:\Rigol","Rigol1.RAF"
Delete the specified file or empty folder in the current directory of the external memory.
| Name | Type | Values | Description |
|---|---|---|---|
| <file_name> | string | - | The filename of the file or the folder name of the empty folder in the current directory of the external memory. |
:MMEM:DEL "Rigol1.RAF" /*Delete the file Rigol1.RAF in the external memory (D:\)*/
Load the specified state file or arbitrary waveform file in the current directory of the external memory.
| Name | Type | Values | Description |
|---|---|---|---|
| <file_name> | string | - | The filename of the state file or the arbitrary waveform file in the current directory of the external memory. |
:MMEM:LOAD "Rigol0.RSF" /*Load the file Rigol0.RSF in the external memory (D:\)*/
Loads the specified arbitrary waveform file from the current directory of the external memory into the specified channel. This command applies only to external memory.
| Name | Type | Values | Description |
|---|---|---|---|
| channelopt | discrete | 1 - 2 | Selects the target channel: CH1 or CH2. If omitted, the file is loaded into CH1. |
| file_name | string | - | Filename of the arbitrary waveform file in the current directory of the external memory, enclosed in double quotation marks. |
:MMEM:LOAD:DATA "Rigol4.RAF"
Load the specified state file in the current directory of the external memory.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | The filename of the state file in the current directory of the external memory. |
:MMEM:LOAD "Rigol0.RSF"
Creates a folder in the current directory of the external memory with the specified name. This command is only applicable to the external memory.
| Name | Type | Values | Description |
|---|---|---|---|
| dir_name | string | - | Name of the folder to be created; must be enclosed in double quotation marks and cannot exceed 9 characters. |
:MMEM:MDIR "RIGOL1" /*Create a folder named “RIGOL1” in D disk*/
Queries the available disk drives in external memory. The response is a string giving the number of available drives and their names, or "0,\"NULL\"" if none are available.
Delete the specified empty directory in the external memory.
| Name | Type | Values | Description |
|---|---|---|---|
| folder | string | - | Folder name of the empty folder in the external memory. |
:MMEM:RDIR "111" /*Delete the empty folder 111 in the external memory*/
Stores the current instrument state or the arbitrary waveform data of the current channel into external memory under the specified file name. The command is only applicable to external memory; the filename must be enclosed in double quotation marks and include the .RSF or .RAF suffix.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | Filename of the specified state file or arbitrary waveform file. |
:MMEM:STOR "R00.RSF" /*Store the current instrument state into D disk in the state file form with the filename R00.RSF*/
Stores the arbitrary waveform data of the specified channel into the current directory of the external memory as an arbitrary waveform file. It is only applicable to external memory.
| Name | Type | Values | Description |
|---|---|---|---|
| channel | enum | 1 | 2 | Specifies which channel's arbitrary waveform data to store. |
| file_name | string | - | Filename of the specified arbitrary waveform file. |
:MMEM:STOR:DATA "R11.RAF"
Stores the current instrument state into the current directory of the external memory as a state file with the specified filename.
| Name | Type | Values | Description |
|---|---|---|---|
| <file_name> | string | - | Filename for the state file, enclosed in double quotation marks, including the .RSF suffix. |
:MMEM:STOR:STAT "R22.RSF" /*Store the current instrument state into D disk in state file form with the filename R22.RSF*/
Sets or queries the gate polarity of the specified channel in gated mode. When [<n>] is omitted, CH1 is used by default.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Specifies the channel number. |
| polarity | enum | POSitive | NEGative | Sets the gate polarity to positive or negative. |
:OUTP1:GAT:POL NEG /*Set the gate polarity of CH1 in the gated mode to negative*/ :OUTP1:GAT:POL? /*Query the gate polarity of CH1 in the gated mode and the query returns NEGATIVE*/
Sets the output impedance of the specified channel's output connector. The query form returns the output impedance in scientific notation with 7 effective digits; INFinity is returned as 9.900000E+37.
| Name | Type | Values | Description |
|---|---|---|---|
| <n>opt | discrete | 1 - 2 | Selects the output channel; when omitted, CH1 is used by default. |
| ohms | integer | 1Ω - 10kΩ | Sets the output impedance to a specified value within the allowed range. |
:OUTP1:IMP INF :OUTP1:IMP? :OUTP1:LOAD 100 :OUTP1:LOAD?
Sets the output impedance of the output connector of the specified channel. The channel defaults to CH1 when [<n>] is omitted.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 | 2 | Selects the output channel. |
| <ohms> | integer | 1Ω - 10kΩ | Sets the output impedance to a specified value within the available range. |
| qualifieropt | enum | MINimum | MAXimum | Optional query qualifier for :OUTPut[<n>]:LOAD?. |
:OUTP1:LOAD 100 :OUTP1:LOAD?
Sets the output mode of the specified channel's output connector to normal or gated, and the query returns the current mode. When <n> is omitted, CH1 is used by default.
| Name | Type | Values | Description |
|---|---|---|---|
| <n>opt | discrete | 1 - 2 | Specifies the output channel number. |
| mode | enum | NORMal | GATed | Selects normal or gated output mode. |
:OUTP1:MODE GAT :OUTP1:MODE?
Sets or queries the output polarity of the specified channel. Normal polarity is NORMal and inverted polarity is INVerted; when <n> is omitted, CH1 is used by default.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | discrete | 1 - 2 | Specifies the channel number. |
| polarity | enum | NORMal | INVerted | Sets the output polarity to normal or inverted. |
:OUTP1:POL NORM /*Set the output polarity of CH1 to normal*/ :OUTP1:POL? /*Query the output polarity of CH1 and the query returns NORMAL*/
Turns on or off the output of the specified channel, and queries the output status of the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Selects the output channel; when omitted, CH1 is used by default. |
| state | enum | ON | 1 | OFF | 0 | Sets the output state to on or off. |
:OUTP1? /*Query the output status of CH1 and the query returns OFF*/ :OUTP1 ON /*Turn on the output of CH1*/ :OUTP1? /*Query the output status of CH1 and the query returns ON*/
Sets the output delay time of the sync signal on the rear-panel [Mod/Trig/FSK/Sync] connector for the specified channel. When the modulation, sweep, or burst function is enabled, the delay setting is invalid.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Specifies the channel number; if omitted, CH1 is used by default. |
| <delay> | real | 0s - the carrier period | Output delay time of the sync signal. |
| qualifieropt | enum | MINimum | MAXimum | Use MINimum or MAXimum in place of a numeric delay value. |
:OUTP1:SYNC:DEL 0.001 :OUTP1:SYNC:DEL?
Sets or queries the output polarity of the sync signal on the specified channel's rear-panel [Mod/Trig/FSK/Sync] connector. Normal output is POSitive; inverted output is NEGative.
| Name | Type | Values | Description |
|---|---|---|---|
| [<n>]opt | discrete | 1 - 2 | Specifies the channel number; if omitted, CH1 is used by default. |
| mode | enum | POSitive | NEGative | Selects normal or inverted sync-signal polarity. |
:OUTP1:SYNC:POL POS :OUTP1:SYNC:POL?
Enables or disables the sync signal output from the [Mod/Trig/FSK/Sync] connector of the specified channel at the rear panel. The query returns the current sync output status.
| 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 | Enables or disables the sync signal output. |
:OUTP1:SYNC 1 :OUTP1:SYNC? :OUTP1:SYNC OFF :OUTP1:SYNC?
Sets or queries the gain of the signal amplification at the PA output terminal. The gain can be set to 1X or 10X.
| Name | Type | Values | Description |
|---|---|---|---|
| gain | enum | 1X | 10X | Gain setting for the PA output amplification. |
:PA:GAIN 10X :PA:GAIN?
Turns on or off the output offset at the output terminal of the PA. The query returns the on/off status.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | On/off state of the output offset at the output terminal of the PA. |
:PA:OFFS ON /*Turn on the output offset at the output terminal of the PA*/ :PA:OFFS? /*Query the on/off status of the output offset at the output terminal of the PA and the query returns ON*/
Sets the output offset at the output terminal of the PA. The query form returns the output offset in scientific notation with 7 effective digits.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | -12V - 12V | Output offset value to set. |
| qualifieropt | enum | MINimum | MAXimum | Sets or queries the minimum or maximum output offset value. |
Sets the output polarity of the PA output terminal to normal or inverted. The query returns the current polarity as NORMAL or INVERTED.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | NORMal | INVerted | Selects normal or inverted output polarity. |
:PA:OUTP:POL NORM /*Set the output polarity of the signal at the output :PA:OUTP:POL? /*Query the output polarity of the signal at the output
Save the current working state of the PA into the internal memory of the instrument.
Turn the external power amplifier on or off. The query returns the on/off status of the external power amplifier.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | Turns the external power amplifier on or off. |
:PA ON :PA?
Sets the system clock source to internal or external. When external is selected and no valid external clock is detected, the instrument switches to internal clock automatically.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | INTernal | EXTernal | Selects the system clock source. |
:ROSC:SOUR INT /*Set the system clock source to internal source*/
Queries the currently selected system clock source. The query returns INT or EXT.
:ROSC:SOUR:CURR? /*Query the system clock source currently selected and the query returns INT*/
Generate a beep immediately. This command is not affected by the current beeper on/off status.
Turn on or off the beeper.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | Beeper on/off state. |
":SYST:BEEP:STAT 1" ":SYST:BEEP:STAT?"
Select the current channel or query the current channel.
| Name | Type | Values | Description |
|---|---|---|---|
| channel | enum | CH1 | CH2 | Channel to select as the current channel. |
:SYST:CHAN:CUR CH2 :SYST:CHAN:CUR?
Query the number of channels of the instrument.
Sets the GPIB address of the instrument, or queries the current GPIB address. The query returns the address in scientific notation with 7 effective digits.
| Name | Type | Values | Description |
|---|---|---|---|
| integer | integer | 0 - 30 | GPIB address to assign to the instrument. |
:SYST:COMM:GPIB:ADDR 7 :SYST:COMM:GPIB:ADDR?
Applies the current LAN network parameters. The new settings take effect only after this command is executed.
Turns the LAN AutoIP configuration mode on or off. The query returns the current AutoIP status.
| Name | Type | Values | Description |
|---|---|---|---|
| stateopt | enum | ON | 1 | OFF | 0 | Enables or disables the AutoIP configuration mode. |
:SYST:COMM:LAN:AUTO OFF :SYST:COMM:LAN:AUTO?
Query the number of the initial control connecting terminal used for socket communication.
Turns DHCP configuration mode on or off. The query returns the current DHCP mode status.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | Sets the DHCP configuration mode. |
:SYST:COMM:LAN:DHCP OFF :SYST:COMM:LAN:DHCP?
Sets the DNS (Domain Name Service) address, or queries the current DNS address. The command is only valid when ManualIP configuration mode is enabled, and the new setting takes effect after :SYSTem:COMMunicate:LAN:APPLy is executed.
| Name | Type | Values | Description |
|---|---|---|---|
| address | string | - | DNS address in nnn.nnn.nnn.nnn format, with the first octet from 1 to 223 except 127 and the other three octets from 0 to 255. |
:SYST:COMM:LAN:DNS 202.106.46.151 :SYST:COMM:LAN:DNS?
Set the domain name. Query the domain name.
| Name | Type | Values | Description |
|---|---|---|---|
| name | string | - | The specified domain name; it can include English characters and numbers and cannot exceed 99 characters. |
:SYST:COMM:LAN:DOM RIGOL :SYST:COMM:LAN:DOM?
Sets or queries the default gateway for the LAN interface. The command is only valid when ManualIP configuration mode is turned on, and changes take effect after :SYSTem:COMMunicate:LAN:APPLy is executed.
| Name | Type | Values | Description |
|---|---|---|---|
| address | string | - | Default gateway address in nnn.nnn.nnn.nnn format. |
:SYST:COMM:LAN:GATE 192.168.1.1 :SYST:COMM:LAN:GATE?
Set or query the LAN host name. The host name is an ASCII string up to 99 characters and may include English characters and numbers.
| Name | Type | Values | Description |
|---|---|---|---|
| name | string | 99 characters | Specified host name. |
:SYST:COMM:LAN:HOST RIGOL123 /*Set the host name to RIGOL123*/ :SYST:COMM:LAN:HOST? /*Query the host name and the query returns RIGOL123*/
Sets the IP address or queries the current IP address. The command is only valid when ManualIP configuration mode is on, and the new setting takes effect after :SYSTem:COMMunicate:LAN:APPLy is executed.
| Name | Type | Values | Description |
|---|---|---|---|
| ip_address | string | - | IP address in nnn.nnn.nnn.nnn format; the first octet ranges from 1 to 223 except 127, and the other three octets range from 0 to 255. |
:SYST:COMM:LAN:IPAD 192.168.1.88 :SYST:COMM:LAN:IPAD?
Queries the MAC address of the instrument. The query returns the MAC address as a string, for example 00-14-0E-42-12-CF.
:SYSTem:COMMunicate:LAN:MAC?
Sets the subnet mask or queries the current subnet mask. The command is only valid when ManualIP configuration mode is on, and the new settings take effect after :SYSTem:COMMunicate:LAN:APPLy is executed.
| Name | Type | Values | Description |
|---|---|---|---|
| mask | string | - | Subnet mask in nnn.nnn.nnn.nnn format, with each nnn ranging from 0 to 255. |
:SYST:COMM:LAN:SMAS 255.255.255.0 :SYST:COMM:LAN:SMAS?
Turns on or off the ManualIP configuration mode. The query returns the current status of the ManualIP configuration mode.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | Selects whether ManualIP configuration mode is enabled or disabled. |
:SYST:COMM:LAN:STAT ON :SYST:COMM:LAN:STAT?
Store all the modifications of the LAN setting to non-volatile memory and restart the LAN drive program using the updated setting.
Query the USB information of the instrument.
Sets or queries the type of device connected to the rear-panel USB Device interface. Use COMPuter for a computer connection or PRINter for a printer connection.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | COMPuter | PRINter | Selects the USB device class. |
:SYST:COMM:USB:CLAS PRIN /*Set the type of the device connected to the USB Device interface at the rear panel of the instrument to printer*/ :SYST:COMM:USB:CLAS? /*Query the type of the device connected to the USB Device interface at the rear panel of the instrument and the query returns PRIN*/
Copies all parameters, states, and arbitrary waveform data from one channel to the other, except for the channel output on/off state. The two channel names must be different; valid combinations are CH1,CH2 or CH2,CH1.
| Name | Type | Values | Description |
|---|---|---|---|
| name | enum | CH1 | CH2 | Channel name to copy from or to. |
| name | enum | CH1 | CH2 | Channel name to copy to or from. |
:SYST:CSC CH1,CH2
Queries and clears an error message in the error queue. The query returns the oldest error as a comma-separated error number and quoted message string.
Lock or unlock the front-panel keys. The query checks whether the front-panel keys are locked.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | 1 | OFF | 0 | Locks or unlocks the front-panel keys. |
:SYST:KLOC 1 /*Lock the front-panel keys*/ :SYST:KLOC? /*Query whether the front-panel keys are locked and the query returns ON*/ :SYST:KLOC OFF /*Unlock the front-panel keys*/ :SYST:KLOC? /*Query whether the front-panel keys are locked and the query returns OFF*/
Sets the system language to English or simplified Chinese. The query returns the current language setting.
| Name | Type | Values | Description |
|---|---|---|---|
| language | enum | ENGLish | SCHinese | System language to select. |
:SYST:LANG SCH /*Set the system language to simplified Chinese*/ :SYST:LANG? /*Query the system language and the query returns SCH*/
Sets the power-on state to default or last. The query returns the current power-on state.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | DEFault | LAST | Selects the power-on state to store. |
:SYST:POW LAST :SYST:POW?
Restore the instrument to the default state or recall 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 one of the stored user state files to recall. |
:SYSTem:PRESet
{DEFault|USER1|USER2|USER3|USER4|USER5|USER6|USER7|USER8|USER9|USER10}Sets the system clock source to internal (INTernal) or external (EXTernal). The query returns the current clock source type.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | INTernal | EXTernal | Selects the system clock source. |
:SYST:ROSC:SOUR INT /*Set the system clock source to internal*/ :SYST:ROSC:SOUR? /*Query the system clock source and the query returns INT*/
Sanitizes all user-accessible instrument memory information. It also restores the instrument settings to factory values, including user-defined state information, arbitrary waveforms, and I/O settings such as the IP address.
Query the system SCPI version information.
Sets the burst delay of the specified channel, or queries the burst delay. When <n> is omitted, CH1 is used by default.
| Name | Type | Values | Description |
|---|---|---|---|
| <n>opt | integer | 1 - 2 | Specifies the channel number. |
| <seconds> | real | 0s - 100s | Sets the burst delay time. |
| qualifieropt | enum | MINimum | MAXimum | Selects the minimum or maximum delay value for the query. |
:TRIG:DEL 1 :TRIG:DEL?
Generates a trigger in the specified channel. If <n> is omitted, the system generates a trigger in CH1 by default.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | discrete | 1 - 2 | Specifies the channel number. |
:TRIG1 /*Generate a trigger in CH1*/
Sets the trigger input edge type for the specified channel to rising (POSitive) or falling (NEGative). The query returns the current edge type.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | discrete | 1 - 2 | Specifies the channel number. |
| mode | enum | POSitive | NEGative | Selects the trigger edge polarity. |
:TRIG1:SLOP NEG :TRIG1:SLOP?
Sets or queries the trigger source of the specified channel. Applicable only to burst or sweep output; when omitted, <n> defaults to CH1.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | discrete | 1 - 2 | Specifies the channel number. |
| source | enum | INTernal | EXTernal | BUS | Selects the trigger source. |
:TRIG1:SOUR INT /*Set the trigger source of CH1 to internal*/ :TRIG1:SOUR? /*Query the trigger source p of CH1 and the query returns INT*/