/

Rigol

/

Rigol DSA710

SCPI COMMAND REFERENCE

Rigol DSA710

Rigol DSA710

The Rigol DSA710 is Rigol's spectrum analyzer in the DSA700 Series family. Its SCPI remote-control interface exposes 247 commands across 20 subsystems - 175 settable and 72 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.

247

Commands

175

Settable

72

Queries

20

Subsystems

SCPI

Verified

2026-07-16

All commands

:ABORtset / query

Gives up the current operation and restarts the sweep.

Sets the value of N used in N dB bandwidth measurement. The query returns the current N value in scientific notation.

NameTypeValuesDescription
rel_amplreal-100 - 100Consecutive real number specifying N in dB.
real - The current N value in scientific notation.
:CALCulate:BANDwidth:NDB -4
:CALCulate:BANDwidth:NDB?

Queries the measurement result of N dB bandwidth. The result is returned in Hz; if the required points are not found, the query returns ----.

integer (Hz) - The bandwidth in Hz, or ---- if points on both sides of the current marker with N dB fall or rise in amplitude are not found.

Sets the X axis to denote frequency or time in the Pass/Fail test. The setting applies to both upper and lower limit lines, and changing the X axis type deletes all points of the current limit line.

NameTypeValuesDescription
modeenumFREQuency | TIMESelects whether the X axis denotes frequency or time.
enum - Returns the current X-axis type in the Pass/Fail test.
:CALCulate:LLINe:CONTrol:DOMain TIME
:CALCulate:LLINe:CONTrol:DOMain?

Query the result of the Pass/Fail test.

enum - Returns the result of the Pass/Fail test; returns UNMEAS if the test is not finished.

Queries the fail ratio of the Pass/Fail test. The query returns the fail ratio in scientific notation.

real - The fail ratio in scientific notation.
:CALCulate:LLINe:FAIL:RATIo?

Sets whether the test stops when the test fails, and queries the current stop-on-fail state.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Whether to stop the test if the test fails.
:CALCulate:LLINe:FAIL:STOP:STATe ON or :CALCulate:LLINe:FAIL:STOP:STATe 1
:CALCulate:LLINe:FAIL:STOP:STATe?

Sets the frequency interpolation mode for a pass/fail limit line, or queries the current interpolation mode. Lower limit line is <n>=1 and upper limit line is <n>=2.

NameTypeValuesDescription
ninteger1 - 2Selects the lower limit line (1) or upper limit line (2).
modeenumLOGarithmic | LINearSets the interpolation mode to logarithmic or linear.
enum - Returns the interpolation mode as LOG or LIN.
:CALCulate:LLINe1:CONTrol:INTerpolate:TYPE LOGarithmic
:CALCulate:LLINe1:CONTrol:INTerpolate:TYPE?

Create a limit line of the Pass/Fail test. Query the limit line information.

NameTypeValuesDescription
ndiscrete1 - 2Denotes the lower limit line (1) or upper limit line (2).
x-axisreal0 Hz - 1 GHzThe frequency or time of the point being edited when the X axis uses frequency.
x-axisreal0 us - 1 ksThe frequency or time of the point being edited when the X axis uses time.
amplreal-400 dBm - 320 dBmThe amplitude of the point being edited.
connecteddiscrete0 - 1Indicates whether the point is connected to the previous point.
returns

In Pass/Fail test, adds points onto the limit line being edited. Up to 200 points can be edited for each limit line.

NameTypeValuesDescription
<n>discrete1 | 2Denotes the lower limit line (1) or upper limit line (2).
<x-axis>real0 Hz - 1 GHzFrequency of the point being edited when the X axis denotes frequency.
<x-axis>real0 us - 1 ksTime of the point being edited when the X axis denotes time.
<ampl>real-400 dBm - 320 dBmAmplitude of the point being edited.
<connected>discrete0 | 1Whether to connect the current point with the previous one; 1 means yes and 0 means no.
:CALCulate:LLINe2:DATA:MERG 250,200,1,300,250,1

Delete the specified limit line of the Pass/Fail test.

NameTypeValuesDescription
ndiscrete1 - 2Denotes the lower limit line (1) or the upper limit line (2).
:CALCulate:LLINe1:DELete

Enable or disable the REL Amplitude for the specified limit line. The query returns the current REL Amplitude status as 0 or 1.

NameTypeValuesDescription
ndiscrete1 - 2Denotes the lower limit line (1) or the upper limit line (2).
stateoptbooleanOFF | ON | 0 | 1Turns REL Amplitude off or on.
enum - Returns the REL Amplitude status as 0 or 1.
:CALCulate:LLINe1:RELAmpt:STATe ON or :CALCulate:LLINe1:RELAmpt:STATe 1
:CALCulate:LLINe1:RELAmpt?

Enable or disable the REL Frequency. Query the status of the REL Frequency.

NameTypeValuesDescription
ninteger1 - 2Denotes the lower limit line (1) or upper limit line (2).
stateoptenumOFF | ON | 0 | 1Enables or disables REL Frequency.
enum - The query returns 0 or 1.
:CALCulate:LLINe1:RELFreq:STATe ON
:CALCulate:LLINe1:RELFreq:STATe 1
:CALCulate:LLINe1:RELFreq?

Enable or disable the upper/lower limit line. Query the status of the limit lines.

NameTypeValuesDescription
ninteger1 - 2Denotes the lower limit line (1) or upper limit line (2).
stateenumOFF | ON | 0 | 1Turns the limit line on or off.

Sets the resolution of the frequency counter, or queries the current resolution setting. The resolution can be set in discrete steps from 1 Hz to 100 kHz.

NameTypeValuesDescription
freqenum1 Hz | 10 Hz | 100 Hz | 1 kHz | 10 kHz | 100 kHzResolution of the frequency counter.
integer (Hz) - Returns the resolution in integer form; the unit is Hz.
:CALCulate:MARKer:FCOunt:RESolution 1000 or :CALCulate:MARKer:FCOunt:RESolution 1kHz
:CALCulate:MARKer:FCOunt:RESolution?

Sets the resolution of the frequency counter to automatic mode, and queries the status of that auto setting.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Enables or disables automatic resolution setting.
enum - Returns the auto-setting status as 0 or 1.
:CALCulate:MARKer:FCOunt:RESolution:AUTO OFF
:CALCulate:MARKer:FCOunt:RESolution:AUTO 0
:CALCulate:MARKer:FCOunt:RESolution:AUTO?

Queries the reading of the frequency counter.

integer (Hz) - Returns the frequency counter reading in Hz. Returns 9000000000000000 when the frequency counter is disabled.

Enable or disable the frequency counter. Query the status of the frequency counter.

NameTypeValuesDescription
stateoptenumOFF | ON | 0 | 1Enables or disables the frequency counter.
enum - The query returns 0 or 1.
:CALCulate:MARKer:FCOunt:STATe ON or :CALCulate:MARKer:FCOunt:STATe 1
:CALCulate:MARKer:FCOunt:STATe?

Enable continuous peak search and mark the peak using the specified marker, or disable continuous peak search. The query returns the status as 0 or 1.

NameTypeValuesDescription
ndiscrete1 - 4Marker number.
stateoptenumOFF | ON | 0 | 1Enables or disables continuous peak search.
integer - Returns 0 or 1 indicating the current status of continuous peak search.
:CALCulate:MARKer2:CPEak:STATe ON or :CALCulate:MARKer2:CPEak:STATe 1
:CALCulate:MARKer2:CPEak:STATe?

Sets the center frequency of the spectrum analyzer to the frequency difference of the specified Delta, Delta Pair, or Span Pair marker. The command is invalid in zero span mode.

NameTypeValuesDescription
ndiscrete1 - 4Marker number to use.
:CALCulate:MARKer1:DELTa:SET:CENTer

Set the span of the spectrum analyzer to the frequency difference of the specified Delta, Delta Pair or Span Pair marker.

NameTypeValuesDescription
ndiscrete1 - 4
:CALCulate:MARKer1:DELTa:SET:SPAN

Select the special measurement type for the specified marker. The query returns the current special measurement type of the specified marker.

NameTypeValuesDescription
ndiscrete1 - 4Specifies the marker number.
modeenumNDB | NOISe | OFFSelects the special measurement type.
enum - Returns the special measurement type of the specified marker.
::CALCulate:MARKer1:FUNCtion NDB
::CALCulate:MARKer1:FUNCtion?

Search and mark the nearest peak located to the left of the current peak on the trace that meets the peak search condition. If no peak is found, "No peak found" is displayed on the screen.

NameTypeValuesDescription
ninteger1 - 4Marker number to use.

Executes a peak search according to the search mode set by :CALCulate:MARKer<n>:PEAK:SEARch:MODE and marks the peak using the specified marker.

NameTypeValuesDescription
ndiscrete1 - 4Marker number.
:CALCulate:MARKer2:MAXimum:MAX

Search and mark the peak whose amplitude is closest to that of the current peak and which meets the peak search condition.

NameTypeValuesDescription
ninteger1 - 4Marker number to use.

Search and mark the nearest peak which is located at the right side of the current peak and meets the peak search condition.

NameTypeValuesDescription
ndiscrete1 - 4
:CALCulate:MARKer2:MAXimum:RIGHt

Search and mark the peak on the trace with the minimum amplitude. When no peak is found, "No peak found" is displayed on the screen.

NameTypeValuesDescription
ndiscrete1 - 4

Sets the type of the specified marker, or queries the current marker type when used as a query. The available marker types are Position, Delta, Band, and Span.

NameTypeValuesDescription
ndiscrete1 - 4Marker number.
modeenumPOSition | DELTa | BAND | SPANMarker type to set.
enum - Returns the marker type.
:CALCulate:MARKer1:MODE POSition
:CALCulate:MARKer1:MODE?

Sets the peak excursion in dB for marker <n>, or queries the current peak excursion. The query returns the peak excursion in scientific notation.

NameTypeValuesDescription
ndiscrete1 - 4
rel_amplreal0 dB - 200 dBPeak excursion value to set.
real - The peak excursion in scientific notation.
:CALCulate:MARKer1:PEAK:EXCursion 12
:CALCulate:MARKer1:PEAK:EXCursion?

Sets the peak search mode. The query returns the current peak search mode as PAR or MAX.

NameTypeValuesDescription
ndiscrete1 - 4
modeenumPARameter | MAXimumSearch mode: parameter-based peak search or maximum search.
enum - Returns the peak search mode.

Executes a peak search using the specified marker and sets the spectrum analyzer center frequency to the frequency of the current peak.

NameTypeValuesDescription
ndiscrete1 - 4Marker number.
:CALCulate:MARKer1:PEAK:SET:CF

Set the peak threshold for marker <n>. The threshold unit is dBm. The query returns the peak threshold in scientific notation.

NameTypeValuesDescription
ndiscrete1 - 4Marker number to use.
amplreal-200 dBm - 0 dBmPeak threshold amplitude.
real - The peak threshold in scientific notation.
:CALCulate:MARKer1:PEAK:THReshold -100
:CALCulate:MARKer1:PEAK:THReshold?

Execute peak-peak search and mark the peak using the specified marker. The specified marker automatically changes to Delta Pair after execution, and the reference and delta markers indicate the peak-peak positions respectively.

NameTypeValuesDescription
<n>discrete1 - 4Marker number to use.
:CALCulate:MARKer1:PTPeak

Set the center frequency of the spectrum analyzer to the frequency of the specified marker.

NameTypeValuesDescription
ndiscrete1 - 4Marker number to use.
:CALCulate:MARKer1:SET:CENTer

Sets the spectrum analyzer reference level to the amplitude of the specified marker. For Normal markers, it uses the marker amplitude; for Delta, Delta Pair, or Span Pair markers, it uses the delta marker amplitude.

NameTypeValuesDescription
ndiscrete1 - 4Specifies which marker is used.
:CALCulate:MARKer2:SET:RLEVel

Set the start frequency of the spectrum analyzer to the frequency of the specified marker.

NameTypeValuesDescription
ndiscrete1 - 4Marker number to use.
:CALCulate:MARKer3:SET:STARt

Sets the center frequency step of the spectrum analyzer to the frequency of the specified marker. The command is only available when the specified marker is enabled and is invalid in zero span mode.

NameTypeValuesDescription
ndiscrete1 | 2 | 3 | 4Specifies the marker number.
:CALCulate:MARKer4:SET:STEP

Set the stop frequency of the spectrum analyzer to the frequency of the specified marker. The command is only available when the specified marker is enabled and is invalid in zero span mode.

NameTypeValuesDescription
ndiscrete1 | 2 | 3 | 4Specifies the marker number to use.
:CALCulate:MARKer2:SET:STOP

Enables or disables the specified marker. The query returns the status of the specified marker.

NameTypeValuesDescription
ndiscrete1 - 4Marker number.
stateenumOFF | ON | 0 | 1Enable or disable the marker.
enum - Returns the marker status as 0 or 1.
:CALCulate:MARKer1:STATe ON or :CALCulate:MARKer1:STATe 1
:CALCulate:MARKer1:STATe?

Set the trace to be marked by the specified marker. The query returns the marker trace, or the trace number currently marked by the marker if the marker trace is set to Auto.

NameTypeValuesDescription
ninteger1 - 4Marker number.
integerinteger1 - 4Trace number to select; trace 1, 2, 3, or 4 (math trace).
integer - Returns the marker trace number, or the trace number marked by the marker if the marker trace is set to Auto.
:CALCulate:MARKer1:TRACe 1
:CALCulate:MARKer1:TRACe?

Set the specified marker trace to Auto. Query whether the marker trace is set to Auto.

NameTypeValuesDescription
ndiscrete1 - 4Marker number.
statebooleanOFF | ON | 0 | 1Enables or disables Auto for the marker trace.
integer - Returns 0 when Auto is disabled and 1 when Auto is enabled.
:CALCulate:MARKer1:TRACe:AUTO ON or :CALCulate:MARKer1:TRACe:AUTO 1
:CALCulate:MARKer1:TRACe:AUTO?

Sets or queries the X-axis value of the specified marker. The default unit is Hz.

NameTypeValuesDescription
ndiscrete1 - 4Marker number.
paramreal-X-axis value to set, within the range currently available of the X axis.
real - Returns the X-axis value of the marker. In frequency or reciprocal-of-time readout mode, the value is returned as an integer; in time or period mode, it is returned in scientific notation.
:CALCulate:MARKer1:X 15000000
:CALCulate:MARKer1:X?

Sets or queries the X-axis center value of the specified Span Pair marker.

NameTypeValuesDescription
ndiscrete1 - 4Marker number.
paramreal-X-axis center value; must be within the current X-axis range.
numeric - Returns the X-axis center value of the specified marker. In frequency mode the value is returned as an integer in Hz; in time or period mode it is returned in scientific notation in s.
:CALCulate:MARKe1:X:CENTer 1500000000 or :CALCulate:MARKe1:X:CENTer 1.5GHZ
:CALCulate:MARKe1:X:CENTer?

Sets the position of the specified Normal marker. The query returns the marker position as an integer.

NameTypeValuesDescription
ndiscrete1 | 2 | 3 | 4Specifies which marker to address.
integerinteger0 - 600Sets the marker position.
integer - Returns the position of the marker in integer.
:CALCulate:MARKer1:X:POSition 100
:CALCulate:MARKer1:X:POSition?

Sets the center position of the specified Span Pair marker, or queries that center position. The marker index n is 1 to 4.

NameTypeValuesDescription
ndiscrete1 - 4Specifies the marker number.
paraminteger0 - 600Center position value.
:CALCulate:MARKer1:X:POSition:CENTer 200
:CALCulate:MARKer1:X:POSition:CENTer?

Sets the number of points corresponding to the span of the specified Span Pair marker. The query returns that number of points in integer form.

NameTypeValuesDescription
ndiscrete1 | 2 | 3 | 4Specifies which marker number to use.
paraminteger0 - 600Number of points corresponding to the span.
integer - The number of points corresponding to the span of the specified Span Pair marker.
:CALCulate:MARKer1:X:POSition:SPAN 150
:CALCulate:MARKer1:X:POSition:SPAN?

Set the position of the reference marker of the specified Delta Pair marker. Query the position of the reference marker of the specified Delta Pair marker.

NameTypeValuesDescription
ndiscrete1 - 4
paraminteger0 - 600Position of the reference marker.
:CALCulate:MARKer1:X:POSition:STARt 100
:CALCulate:MARKer1:X:POSition:STARt?

Sets or queries the position of the delta marker of the specified Delta Pair marker. The query returns the position as an integer.

NameTypeValuesDescription
ndiscrete1 | 2 | 3 | 4Specifies which marker to use.
paraminteger0 - 600Sets the delta marker position.
integer - The position of the delta marker in integer.
:CALCulate:MARKer1:X:POSition:STOP 300
:CALCulate:MARKer1:X:POSition:STOP?

Sets or queries the X-axis readout mode of the specified marker. The available modes are frequency, time, inverse time, and period.

NameTypeValuesDescription
ndiscrete1 - 4Marker number.
modeenumFREQuency | TIME | ITIMe | PERiodX-axis readout mode.
enum - Returns the readout mode of the X axis of the specified marker.
:CALCulate:MARKer1:X:READout TIME
:CALCulate:MARKer1:X:READout?

Sets or queries the X value corresponding to the span of the specified Span Pair marker. The query returns the marker span X value, with the unit and numeric format depending on the current readout mode.

NameTypeValuesDescription
ndiscrete1 - 4Selects the Span Pair marker number.
paramreal-X-axis value for the marker span; must be within the currently available X-axis range.
numeric (Hz/s) - When readout mode is frequency, returns the X value of the marker span as an integer in Hz. When readout mode is time or period, returns the X value in scientific notation with units of seconds.
:CALCulate:MARKer1:X:SPAN 500000000
:CALCulate:MARKer1:X:SPAN?

Set the X value of the reference marker of the specified Delta Pair marker. Query the X value of the reference marker of the specified Delta Pair marker.

NameTypeValuesDescription
ndiscrete1 - 4Specifies the marker number.
paramreal-Consecutive real number for the X-axis position of the marker reference.

Sets or queries the X value of the delta marker for the specified Delta Pair marker. The allowed units and effective range depend on whether the readout mode is frequency, time, or period.

NameTypeValuesDescription
ndiscrete1 | 2 | 3 | 4Specifies the marker number.
paramreal-Consecutive real number within the currently available X-axis range.
real (s) - Returns the X value of the delta marker. In frequency mode the value is returned as an integer in Hz; in time or period mode it is returned in scientific notation in s.
:CALCulate:MARKer1:X:STOP 350000000
:CALCulate:MARKer1:X:STOP?

Query the Y-axis value of the specified marker. The default unit is dBm; for Delta, Delta Pair, or Span Pair markers, it returns the Y-axis difference between the reference marker and the delta marker.

NameTypeValuesDescription
ndiscrete1 - 4Specifies the marker number to query.
string - The Y-axis value in scientific notation.
CALCulate:MARKer1:Y?

Enable or disable the marker table. The query returns the status of the marker table.

NameTypeValuesDescription
statebooleanOFF | ON | 0 | 1Enable or disable the marker table.
:CALCulate:MARKer:TABLe:STATe OFF or :CALCulate:MARKer:TABLe:STATe 0
:CALCulate:MARKer:TABLe:STATe?

Enable or disable the signal track. The query reports the signal track status.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Turns signal tracking off or on.

Enable or disable auto calibration. The query returns the current auto calibration status.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Turns auto calibration off or on.
enum - Returns the auto calibration status as 0 or 1.
:CALibration:AUTO ON or :CALibration:AUTO 1
:CALibration:AUTO?

Queries the current measurement function.

enum - Returns the current measurement function state.

Sets the spectrum analyzer to the adjacent channel power measurement state. The command stops the current measurement and sets the instrument to the default state of the specified measurement.

Set the spectrum analyzer to the channel power measurement state. It stops the current measurement and sets the instrument to the default state of the specified measurement.

Set the spectrum analyzer to the C/N ratio measurement state. The command stops the current measurement and restores the specified measurement to its default state.

Set the spectrum analyzer to the emission bandwidth measurement state. This command stops the current measurement and sets the instrument to the default state of the specified measurement.

:CONFigure:HDIStset / query

Set the spectrum analyzer to the harmonic distortion measurement state. The command stops the current measurement and sets the instrument to the default state of the specified measurement.

Set the spectrum analyzer to the occupied bandwidth measurement state. This command stops the current measurement and sets the instrument to the default state of the specified measurement.

Disables the current measurement function and sets the spectrum analyzer to sweep mode.

:CONFigure:TOIset / query

Set the spectrum analyzer to the TOI measurement state. It stops the current measurement and sets the instrument to the default state of the specified measurement.

Set the spectrum analyzer to the T-power measurement state. This command stops the current measurement and sets the instrument to the default state of the specified measurement.

:COUPleset / query

Sets all related parameters automatically according to the coupling relationship, or queries the current coupling-linked setting status.

NameTypeValuesDescription
stateenumALL | NONECoupling-linked setting state.
enum - The query returns the current coupling status as ALL or NONE.
:COUPle NONE
:COUPle?

Sets or queries the position of the active function area on the screen.

NameTypeValuesDescription
positionenumBOTTom | CENTer | TOPPosition of the active function area.
enum - The query returns the position as BOTT, CENT, or TOP.
:DISPlay:AFUnction:POSition CENTer
:DISPlay:AFUnction:POSition?

Enable or disable the display of the time and date. Queries the status of the display of the time and date.

NameTypeValuesDescription
stateoptbooleanOFF | ON | 0 | 1Turns the clock annotation display off or on.
:DISPlay:ANNotation:CLOCk:STATe ON
:DISPlay:ANNotation:CLOCk:STATe 1
:DISPlay:ANNotation:CLOCk:STATe?

Set or query the screen brightness.

NameTypeValuesDescription
integerinteger0 - 7Brightness level to set.
integer - The query returns the brightness in integer.
:DISPlay:BRIGhtness 6
:DISPlay:BRIGhtness?
:DISPlay:ENABleset / query

Sets the on/off state of the screen. The query returns the screen state as 0 or 1.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Screen on/off state.
integer - Returns 0 or 1 indicating the screen state.
:DISPlay:ENABle OFF or :DISPlay:ENABle 0
:DISPlay:ENABle?

Enable or disable the message display. Query the status of message display.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Sets the message display state.
enum - The query returns 0 or 1.
:DISPlay:MSGswitch:STATe OFF or :DISPlay:MSGswitch:STATe 0
:DISPlay:MSGswitch:STATe?

Enable or disable the display of the UserKey definition in the user interface. Query whether the UserKey definition is displayed in the user interface.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Enables or disables the display of the UserKey definition in the user interface.
:DISPlay:UKEY:STATe ON or :DISPlay:UKEY:STATe 1
:DISPlay:UKEY:STATe?

Sets the brightness of the screen grid, or queries the current screen-grid brightness.

NameTypeValuesDescription
integerinteger0 - 10Brightness level of the screen grid.
integer - Returns the brightness of the screen grid as an integer.
:DISPlay:WINdow:TRACe:GRATicule:GRID 2
:DISPlay:WINdow:TRACe:GRATicule:GRID?

Sets the X-axis scale spacing type for the trace display. The query returns the current X-axis scale type.

NameTypeValuesDescription
spacingenumLINear | LOGarithmicSelects linear or logarithmic X-axis spacing.
enum - Returns the X-axis scale spacing type.
:DISPlay:WINdow:TRACe:X:SCALe:SPACing LOGarithmic
:DISPlay:WINdow:TRACe:X:SCALe:SPACing?

Sets the position of the display line on the screen. The default unit is dBm, and the position is retained as the last setting even across preset.

NameTypeValuesDescription
amplrealThe current amplitude rangePosition of the display line.
::DISPlay:WINdow:TRACe:Y:DLINe -10
::DISPlay:WINdow:TRACe:Y:DLINe?

Enables or disables the display line. The query returns the display line status as 0 or 1.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Enable or disable the display line.

Sets the Y-axis scale for the display window trace. The query returns the current Y-axis scale in scientific notation.

NameTypeValuesDescription
rel_amplreal0.1 dB - 20 dBY-axis scale value.
string - The query returns the Y-axis scale in scientific notation.
:DISPlay:WINdow:TRACe:Y:SCALe:PDIVision 15
:DISPlay:WINdow:TRACe:Y:SCALe:PDIVision?

Sets or queries the reference level for the trace Y-axis scale. The query returns the reference level in scientific notation.

NameTypeValuesDescription
amplreal-100 - 20Reference level value.
real - The query returns the reference level in scientific notation.
:DISPlay:WINdow:TRACe:Y:SCALe:RLEVel -10
:DISPlay:WINdow:TRACe:Y:SCALe:RLEVel?

Sets the offset of the reference level, and the query returns that offset. The offset modifies the reference level and amplitude readout of the marker without changing the curve position.

NameTypeValuesDescription
<rel_ampl>real-300 dB - 300 dBRelative amplitude offset to apply to the reference level.
string - The query returns the offset of the reference level in scientific notation.
:DISPlay:WINdow:TRACe:Y:SCALe:RLEVel:OFFSet 10
:DISPlay:WINdow:TRACe:Y:SCALe:RLEVel:OFFSet?

Sets or queries the Y-axis scale spacing type.

NameTypeValuesDescription
modeenumLINear | LOGarithmicSelects linear or logarithmic Y-axis spacing.
enum - The query returns the Y-axis scale type as LIN or LOG.
:DISPlay:WINdow:TRACe:Y:SCALe:SPACing LOGarithmic
:DISPlay:WINdow:TRACe:Y:SCALe:SPACing?

Query the results of adjacent channel power measurement. It selects data from the latest measurement results and transmits them to the output buffer.

numeric (same as current Y-axis unit) - Returns five values in scientific notation: main channel power, upper channel power, upper channel power difference to the main channel in dBc, lower channel power, and lower channel power difference to the main channel in dBc.
:FETCh:ACPower?

Query the lower channel power of adjacent channel power measurement. It selects the latest measurement result and transmits it to the output buffer.

real - Returns the lower channel power in scientific notation.
FETCh:ACPower:LOWer?

Queries the main channel power of adjacent channel power measurement. The command reads from the latest measurement results and outputs the data buffer value in scientific notation.

real - The main channel power in scientific notation, using the current Y-axis unit.
:FETCh:ACPower:MAIN?

Query the upper channel power of adjacent channel power measurement. It returns data from the latest measurement results and is only available when adjacent channel power measurement is enabled.

real - The upper channel power in scientific notation. The power unit is the same as the current Y-axis unit.
":FETCh:ACPower:UPPer?"

Query the results of channel power measurement. It is only available when channel power measurement is enabled and returns data from the latest measurement results to the output buffer.

numeric - Returns the channel power and the power spectral density in scientific notation, separated by a comma. The power unit is the same as the current Y-axis unit.
:FETCh:CHPower?

Query the channel power. This command is only available when channel power measurement is enabled, and it returns the latest measured channel power from the output buffer.

real - Returns the channel power in scientific notation.
:FETCh:CHPower:CHPower?

Query the channel power spectral density. It selects data from the latest measurement results and sends the value to the output buffer.

real - Returns the channel power spectral density in scientific notation.
:FETCh:CHPower:DENSity?

Query the results of C/N ratio measurement. It selects data from the latest measurement results and transmits them to the output buffer.

numeric (dB) - Returns the carrier power, noise power, and C/N ratio in scientific notation, separated by commas. The C/N ratio is returned in dB.
::FETCh:CNRatio?

Query the carrier power. Only available when the C/N ratio measurement is enabled; it returns the carrier power from the latest measurement results in scientific notation.

real - The carrier power in scientific notation; the power unit is the same as the current Y-axis unit.
. :FETCh:CNRatio:CARRier?
:FETCh:CNRatio:CARRier?

Query the C/N ratio. This command is only available when the C/N ratio measurement is enabled and returns the latest measurement result to the output buffer.

real - Returns the C/N ratio in scientific notation.
:FETCh:CNRatio:CNRatio?

Queries the noise power from the latest C/N ratio measurement results. This command is only available when C/N ratio measurement is enabled.

real - Noise power in scientific notation; the power unit is the same as the current Y-axis unit.
:FETCh:CNRatio:NOISe?

Query the result of emission bandwidth measurement. It selects data from the latest measurement results and transmits it to the output buffer.

integer (Hz) - Returns the emission bandwidth in integer and the unit is Hz.
:FETCh:EBWidth?

Queries the amplitudes of the first 10 harmonics. The first harmonic is the fundamental waveform, and the returned amplitudes use the current Y-axis unit.

real - Returns the amplitudes of the first 10 harmonics in scientific notation, separated by commas; harmonics not measured do not have return values.
:FETCh:HARMonics:AMPLitude:ALL?

Query the percentage of the total harmonic distortion. It is only available when harmonic distortion measurement is enabled, and returns data from the latest measurement results to the output buffer.

numeric - Returns the percentage of the total harmonic distortion in scientific notation.
FETCh:HARMonics:DISTortion?

Queries the frequencies of the first 10 harmonics, with the first harmonic being the fundamental waveform. It returns data from the latest harmonic distortion measurement results when that measurement is enabled.

integer (Hz) - Returns the frequencies of the first 10 harmonics, separated by commas; harmonics not measured do not have return values.
{:FETCh:HARMonics:FREQuency:ALL?}
:FETCh:HARMonics:FREQuency:ALL?

Query the frequency of the fundamental waveform. It is equivalent to :FETCh:HARMonics:FREQuency? 1 and is only available when harmonic distortion measurement is enabled.

integer (Hz) - Returns the frequency of the fundamental waveform.
:FETCh:HARMonics:FUNDamental?

Query the results of occupied bandwidth measurement. It is only available when the occupied bandwidth measurement is enabled, and returns the latest measurement data to the output buffer.

integer (Hz) - Returns the occupied bandwidth (Hz) and the transmit frequency error (Hz), separated by a comma.
:FETCh:OBWidth?

Query the occupied bandwidth. This command is only available when occupied bandwidth measurement is enabled and returns the latest measurement result to the output buffer.

integer (Hz) - Returns the occupied bandwidth in Hz.

Query the transmit frequency error. It selects data from the latest occupied bandwidth measurement results and transmits the data to the output buffer.

integer (Hz) - The transmit frequency error in Hz.
:FETCh:OBWidth:OBWidth:FERRor?

Query the results of TOI measurement. It is only available when the TOI measurement is enabled and returns the latest measurement data to the output buffer.

string - Returns the TOI measurement results in the format: Base Lower frequency (Hz), amplitude, Base Upper frequency (Hz), amplitude, 3rd Order Lower frequency (Hz), amplitude, intercept, 3rd Order Upper frequency (Hz), amplitude, intercept.
:FETCh:TOIntercept?

Queries the minor one of the intercepts of the Third Order Lower and the Third Order Upper. It selects data from the latest TOI measurement results and transmits the data to the output buffer.

real - Returns the minor one in scientific notation.
FETCh:TOIntercept:IP3?

Query the result of T-power measurement. It selects data from the latest measurement results and transmits the data to the output buffer; the return unit matches the current Y-axis unit.

real - Returns the T-power measurement result in scientific notation.
FETCh:TPOWer?

:FORMat:BORDerset / query

Sets the byte order of binary data transmission. The query returns the current byte order as NORM or SWAP.

NameTypeValuesDescription
modeenumNORMal | SWAPpedByte order used for binary data transmission.
enum - Returns the byte order of binary data transmission as NORM or SWAP.
:FORMat:BORDer NORMal
:FORMat:BORDer?

Sets or queries the input/output format of the trace data.

NameTypeValuesDescription
modeenumASCii | REAL[,32]Selects the trace data format.
enum - Returns the current input/output format of the trace data.
:FORMat:TRACe:DATA REAL,32
:FORMat:TRACe:DATA?

Sets the print color to gray or color, and the query returns the current print color state.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Selects gray or color printing.
enum - Returns the current print color state as 0 or 1.
:HCOPy:IMAGe:COLor:STATe OFF
:HCOPy:IMAGe:COLor:STATe 0
:HCOPy:IMAGe:COLor:STATe?

Sets the image type of the print to default or Exif/JPEG. The query returns DEF or EXIF.

NameTypeValuesDescription
modeenumDEFault | EXIFjpegImage type of the print.
enum - The query returns DEF or EXIF.
:HCOPy:IMAGe:FTYPe EXIFjpeg
:HCOPy:IMAGe:FTYPe?

Enable or disable inverted print. Query the status of inverted print.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Enables or disables inverted print.
enum - The query returns 0 or 1.
:HCOPy:IMAGe:INVert ON or :HCOPy:IMAGe:INVert 1
:HCOPy:IMAGe:INVert?

Enable or disable date print. The query returns the current date-print status.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Enables or disables date print.
enum - The query returns 0 or 1.
The command below enables date print. :HCOPy:IMAGe:PTIMe ON or :HCOPy:IMAGe:PTIMe 1 The query below returns 1. :HCOPy:IMAGe:PTIMe?

Set the print quality. Query the print quality.

NameTypeValuesDescription
qualityenumDEFault | NORMal | DRAFt | FINEPrint quality setting.

Set the print orientation to landscape or portrait. Query the print orientation.

NameTypeValuesDescription
modeenumLANDscape | PORTraitPrint orientation.
:HCOPy:PAGE:ORIentation PORTrait
:HCOPy:PAGE:ORIentation?

Set the print copies. The query returns the current print copies.

NameTypeValuesDescription
integerinteger1 - 999Number of print copies to set.
integer - The print copies.
:HCOPy:PAGE:PRINts 10
:HCOPy:PAGE:PRINts?
:HCOPy:PAGE:SIZEset / query

Set or query the page size of the print. The page size can be DEFault, A4, A5, A6, or B5.

NameTypeValuesDescription
page sizeenumDEFault | A4 | A5 | A6 | B5Page size of the print.
:HCOPy:PAGE:SIZE A5
:HCOPy:PAGE:SIZE?

*CLSset / query

Clear all the event registers and clear the error queue.

*ESEset / query

Set or query the enable register for the standard event status register.

NameTypeValuesDescription
valueinteger0 - 255Enable register value.
integer - Returns the enable register for the standard event status register.
*ESR?query

Query and clear the event register for the standard event status register.

integer - Returns an integer equal to the sum of the weights of all bits already set in the register.
*ESR?
*IDN?query

Queries the instrument ID string.

string - The ID string in the format Rigol Technologies,<model>,<serial number>,XX.XX.XX.XX.XX.
*IDN?
*OPCset / query

Sets bit 0 of the standard event status register to 1 after the current operation is finished. The corresponding query, *OPC?, checks whether the current operation is finished.

*OPC
*OPC?
*RSTset / query

Restore the instrument to its default state.

*SREset / query

Sets the enable register for the status byte register, and the query reads back the register value. Bit 0 and bit 1 are unused and always treated as 0.

NameTypeValuesDescription
valueinteger0 - 255Value to load into the status byte register enable register.
integer - Returns the sum of the weights of all bits already set in the enable register.
*SRE 16
*SRE?
*STB?query

Queries the status byte register. The return is the decimal sum of all enabled bits; bits 0 and 1 are always treated as 0.

integer - Returns the status byte register as an integer, equal to the sum of the weights of all bits set in the register.
*STB?
*TRGset / query

Trigger a sweep or measurement immediately.

*TST?query

Query whether the self-check operation is finished.

integer - Returns the result of the self-check operation as an integer status value.
*WAIset / query

Wait for the current operation to finish.

Selects continuous (ON|1) or single (OFF|0) sweep in non-measurement state, or continuous/single measurement in measurement state. The query returns the current sweep or measurement mode.

NameTypeValuesDescription
statebooleanOFF | ON | 0 | 1Selects continuous or single sweep/measurement mode.
integer - Returns 0 or 1 indicating the current sweep or measurement mode.
:INITiate:CONTinuous ON or :INITiate:CONTinuous 1
:INITiate:CONTinuous?

In non-measurement state, initialize a sweep; in measurement state, trigger a measurement. The instrument must be in single measurement mode, and the command is ignored if :INITiate:CONTinuous is ON or 1.

:INITiate:PAUSeset / query

Switch the measurement state of the instrument from "Wait for Trigger" to "Pause".

Restart the current measurement when the instrument is in idle state.

:INITiate:RESumeset / query

Restores the measurement state of the instrument from "Pause" to "Wait for Trigger". It is only available when the measurement function is enabled and continuous measurement mode is selected.

:INPut:IMPedanceset / query

Sets the input impedance for the voltage-to-power conversion. The query returns the current input impedance.

NameTypeValuesDescription
impedancediscrete50 | 75Input impedance for the voltage-to-power conversion.
enum - Returns the input impedance setting.
:INPut:IMPedance 75
:INPut:IMPedance?

:MMEMory:DELeteset / query

Delete the file with the specified filename. The file name should include the path and filename; the operation fails if the file does not exist.

NameTypeValuesDescription
file_namestring-Path and filename of the file to delete.
:MMEMory:DELete E:\Rigol\Trace1.trc

Queries the disk information of the current USB storage device. The return includes the disk name, type, file system, space used, and total capacity.

string - Returns the disk information, including disk name, type, file system, space used, and total capacity.
:MMEMory:DISK:INFormation?
:MMEMory:DISK:INFormation?

Load the specified correction file and execute amplitude correction. The file must exist and should be a .cbl file.

NameTypeValuesDescription
modeenumANTenna | CABLe | OTHer | USERSpecifies the correction file category.
file_namestring-Path and filename of the file to load.
:MMEMory:LOAD:CORRection ANT,D:\Corr0:123.cbl

Loads the edited limit line file (.lim) into the instrument.

NameTypeValuesDescription
file_namestring-Path and filename of the limit line file to load.
:MMEM:LOAD:LIM D:\Limit1:upp1.lim

Load the stored marker table file (.mkr) into the instrument. The file name should contain the path and filename, and the file can only be loaded from external memory.

NameTypeValuesDescription
file_namestring-Path and filename of the marker table file to load.
:MMEMory:LOAD:MTABle E:\Mak.mkr

Loads the specified setup file (.set) into the instrument. The file name must include the path and filename, and the operation fails if the file does not exist.

NameTypeValuesDescription
file_namestring-Path and filename of the setup file to load.
:MMEMory:LOAD:SETUp D:\Setup0:pf.set

Load the specified state file (.sta).

NameTypeValuesDescription
file_namestring-Path and filename of the state file to load.
:MMEMory:LOAD:STATe 1,D:\State0:default.sta

Loads the specified trace file (.trc). The file name must include the path and filename, and the operation fails if the specified file does not exist.

NameTypeValuesDescription
file_namestring-Path and filename of the trace file to load.
:MMEMory:LOAD:TRACe D:\Trace0:t1.trc
:MMEMory:MOVEset / query

Rename the file specified in <file_name1> as <file_name2>. Both file names should include the path and filename, and the operation fails if the specified file does not exist.

NameTypeValuesDescription
file_name1string-Source file name to rename.
file_name2string-New file name to assign to the source file.
:MMEM:MOVE E:\file1.bmp, E:\file2.bmp

Saves the amplitude correction data file with the specified filename. The file name should include the path and filename; .cbl or .csv formats are supported, with .csv limited to the E disk.

NameTypeValuesDescription
modeenumANTenna | CABLe | OTHer | USERSelects the amplitude correction data file type to save.
<file_name>string-ASCII string containing the path and filename of the correction file.
:MMEMory:STORe:CORRection ANT,D:\Corr1:ANT.cbl

Save the limit line currently edited with the specified filename (.lim). If the file already exists, it is overwritten.

NameTypeValuesDescription
file_namestring-Path and filename for the limit file to save.
:MMEMory:STORe:LIMit D:\Limit0:low.lim

Saves the marker table in the USB storage device using the specified filename. The file name should include the path and use .mkr or .csv; if the file already exists, it is overwritten.

NameTypeValuesDescription
file_namestring-Path and filename for the marker table file.
:MMEMory:STORe:PTABle E:\MAK1.mkr

Save the peak table in the USB storage device with the specified filename (.csv). If the specified file already exists, it will be overwritten.

NameTypeValuesDescription
<file_name>string-Path and filename of the file to create or overwrite.
:MMEMory:STORe:PTABle E:\PT1.csv

Saves the current measurement results in the USB storage device with the specified filename (.csv). If the specified file already exists, it is overwritten.

NameTypeValuesDescription
file_namestring-Path and filename for the results file.
:MMEMory:STORe:RESults E:\ACP.csv

Save the current screen image in the USB storage device with the specified filename (.bmp). If the specified file already exists, it will be overwritten.

NameTypeValuesDescription
<file_name>string-Path and filename to use for the saved screen image.
:MMEMory:STORe:SCReen E:\screen.bmp

Saves the current setting to a file with the specified filename (.set). The file name should include the path; if the file already exists, it is overwritten.

NameTypeValuesDescription
file_namestring-Path and filename for the setup file.
:MMEMory:STORe:SETUp D:\Setup1:ST1.set

Save the current instrument state with the specified filename (.sta). If the file already exists, it will be overwritten.

NameTypeValuesDescription
<file_name>string-Path and filename for the state file.
:MMEMory:STORe:STATe 1,E:\state.sta

Saves the specified trace to a file with the specified filename (.trc or .csv). The file name should include the path; .csv files can only be stored on the E disk.

NameTypeValuesDescription
labelenumTRACE1 | TRACE2 | TRACE3 | MATH | ALLSpecifies which trace to save.
file_namestring-ASCII string containing the path and filename for the saved trace file.
The command below stores trace 1 in the D disk with the filename T1.trc.
:MMEMory:STORe:TRACe TRACE1,D:\Trace1:T1.trc

Execute an adjacent channel power measurement and return the measurement results. The query selects data from the latest measurement results and transmits it to the output buffer.

numeric (same as current Y-axis unit) - Returns 5 values in scientific notation: main channel power, upper channel power, upper-channel power difference from main channel (dBc), lower channel power, and lower-channel power difference from main channel (dBc).

Execute an adjacent channel power measurement and return the lower channel power. The power unit of the return value is the same as the current Y-axis unit.

real - Returns the lower channel power in scientific notation.

Execute an adjacent channel power measurement and return the main channel power.

real - Returns the main channel power in scientific notation. The power unit is the same as the current Y-axis unit.
:READ:ACPower:MAIN?

Executes an adjacent channel power measurement and returns the upper channel power. The return value uses the same power unit as the current Y-axis unit and is taken from the latest measurement results.

real (same as current Y-axis unit) - Upper channel power in scientific notation.

Executes a channel power measurement and returns the measurement results. The return values use the current Y-axis unit and are taken from the latest measurement results.

string - Returns the channel power and the power spectral density in scientific notation, separated by a comma.

Execute a channel power measurement and return the channel power.

real - Returns the channel power in scientific notation. The power unit is the same as the current Y-axis unit.
:READ:CHPower:CHPower?

Executes a channel power measurement and returns the channel power spectral density. The returned value is taken from the latest measurement results and uses the current Y-axis unit.

real - Returns the channel power spectral density in scientific notation.

Executes a C/N ratio measurement and returns the measurement results. The query selects data from the latest measurement results and transmits them to the output buffer.

numeric (dB) - Returns the carrier power, noise power, and C/N ratio in scientific notation, separated by commas.
:READ:CNRatio?

Executes a C/N ratio measurement and returns the carrier power. The return value uses the current Y-axis power unit and is transmitted from the latest measurement results to the output buffer.

real (same as current Y-axis unit) - Returns the carrier power in scientific notation.

Execute a C/N ratio measurement and return the C/N ratio. It selects data from the latest measurement results and transmits the data to the output buffer.

numeric - Returns the C/N ratio in scientific notation.

Execute a C/N ratio measurement and return the noise power. The return value is reported in scientific notation, with a power unit the same as the current Y-axis unit.

real - The query returns the noise power in scientific notation.

Execute an emission bandwidth measurement and return the measurement result. The query returns the emission bandwidth as an integer in Hz.

integer (Hz) - The emission bandwidth measured from the latest measurement results.

Execute a harmonic distortion measurement and return the amplitudes of the first 10 harmonics. If fewer than 10 harmonics are measured, unmeasured harmonics have no return values.

real - Returns the amplitudes of the first 10 harmonics in scientific notation, separated by commas. The amplitude unit is the same as the current Y-axis unit.
:READ:HARMonics:AMPLitude:ALL?

Executes a harmonic distortion measurement and returns the percentage of total harmonic distortion. The command transmits the latest measurement result to the output buffer.

real (%) - Returns the percentage of the total harmonic distortion in scientific notation.

Executes a harmonic distortion measurement and returns the frequencies of the first 10 harmonics. If fewer than 10 harmonics are under measurement, the unmeasured harmonics have no return values.

integer (Hz) - Returns the harmonic frequencies in integer form, separated by commas, in Hz.

Executes a harmonic distortion measurement and returns the frequency of the fundamental waveform. It is equivalent to :READ:HARMonics:FREQuency? 1 and returns the latest measurement result from the output buffer.

integer (Hz) - The frequency of the fundamental waveform, in Hz.

Execute an occupied bandwidth measurement and return the measurement results.

integer (Hz) - Returns the occupied bandwidth and the transmit frequency error, separated by a comma.

Execute an occupied bandwidth measurement and return the occupied bandwidth. It selects data from the latest measurement results and transmits the data to the output buffer.

integer (Hz) - Returns the occupied bandwidth in Hz.

Executes an occupied bandwidth measurement and returns the transmit frequency error. The command selects data from the latest measurement results and sends it to the output buffer.

integer (Hz) - The transmit frequency error in Hz.

Executes a TOI measurement and returns the measurement results from the latest measurement data. The return value uses the current Y-axis unit for the power-related fields.

string - Returns the TOI measurement results in the following order: Base Lower frequency (Hz), amplitude, Base Upper frequency (Hz), amplitude, 3rd Order Lower frequency (Hz), amplitude, intercept, 3rd Order Upper frequency (Hz), amplitude, intercept.

Executes a TOI measurement and returns the minor one of the 3rd Order Lower and 3rd Order Upper intercepts. It selects data from the latest measurement results and transmits the value to the output buffer.

real - Returns the minor one in scientific notation.

Execute a T-power measurement and return the measurement result. The return value uses scientific notation and the power unit is the same as the current Y-axis unit.

real (same as current Y-axis unit) - The T-power measurement result in scientific notation.

Query the value of the condition register for the operation status register.

integer - The value of the condition register.

Set the value of the enable register for the operation status register.

NameTypeValuesDescription
integerinteger0 - 32767Value of the operation status enable register.

Query the value of the event register for the operation status register.

integer - The value of the event register in integer.
:STATus:PRESetset / query

Clears the enable registers of the operation status register and the questionable status register.

Query the value of the condition register for the questionable status register.

integer - Returns the value of the condition register of the questionable status register.

Sets or queries the value of the enable register for the questionable status register.

NameTypeValuesDescription
integerinteger0 - 32767Value written to the questionable status register enable register.
integer - Returns the value of the enable register of the questionable status register.

Queries the value of the event register for the questionable status register.

integer - Returns the value of the event register of the questionable status register.

Enable or disable the beeper in Pass/Fail test. The query returns the beeper status.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Beeper state to set.
enum - Returns the beeper status as 0 or 1.
[:SYSTem:]BEEPer:STATe ON
[:SYSTem:]BEEPer:STATe 1
[:SYSTem:]BEEPer:STATe?

Selects the current communication port, or disables all communication ports. The query reports the currently selected communication port.

NameTypeValuesDescription
portenumGPIB | LAN | USB | OFFCurrent communication port to select, or OFF to disable all communication ports.
enum - Returns the currently selected communication port.
:SYSTem:COMMunicate:APORt LAN
:SYSTem:COMMunicate:APORt?

Switch the instrument state to local or remote mode. The query returns the current operation state of the instrument.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Selects local mode when OFF or 0, and remote mode when ON or 1.
:SYSTem:COMMunicate:BRMT OFF or :SYSTem:COMMunicate:BRMT 0
:SYSTem:COMMunicate:BRMT?

Set or query the GPIB address. The address is an integer from 0 to 30, with a default of 18.

NameTypeValuesDescription
integerinteger0 - 30GPIB address to set.
integer - The query returns the GPIB address.
:SYSTem:COMMunicate:GPIB:SELF:ADDRess 16
:SYSTem:COMMunicate:GPIB:SELF:ADDRess?

Enable or disable the auto IP setting mode. The query returns the current status of the auto IP setting mode as 0 or 1.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Turns the auto IP setting mode off or on.
integer - Returns the status of the auto IP setting mode as 0 or 1.
SYSTem:COMMunicate:LAN:SELF:AUToip:STATe OFF
SYSTem:COMMunicate:LAN:SELF:AUToip:STATe 0
SYSTem:COMMunicate:LAN:SELF:AUToip:STATe?

Enable or disable the DHCP mode. Queries return the current DHCP status.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Enables or disables DHCP mode.
integer - Returns the DHCP status as 0 or 1.
:SYSTem:COMMunicate:LAN:SELF:DHCP:STATe OFF or :SYSTem:COMMunicate:LAN:SELF:DHCP:STATe 0
:SYSTem:COMMunicate:LAN:SELF:DHCP:STATe?

Set the IP address. Query the IP address.

NameTypeValuesDescription
ip_addressstring-IP address in nnn.nnn.nnn.nnn format; the first octet is 1 to 223 except 127, and the other three octets are 0 to 255.
string - Returns the current IP address in nnn.nnn.nnn.nnn format.
SYSTem:COMMunicate:LAN:SELF:IP:ADDress 172.16.3.199
SYSTem:COMMunicate:LAN:SELF:IP:ADDress?

Sets or queries the DNS address used by the instrument. The query returns the current DNS address in nnn.nnn.nnn.nnn format.

NameTypeValuesDescription
ip_addressstring-DNS server address in nnn.nnn.nnn.nnn format; first octet 1 to 223 except 127, remaining octets 0 to 255.
string - Current DNS address in nnn.nnn.nnn.nnn format.
:SYSTem:COMMunicate:LAN:SELF:IP:DNSServer 172.16.2.2
:SYSTem:COMMunicate:LAN:SELF:IP:DNSServer?

Sets the default gateway address for the LAN interface, or queries the current default gateway address. The address must be in nnn.nnn.nnn.nnn format with the first octet 1 to 223 except 127, and the remaining octets 0 to 255.

NameTypeValuesDescription
ip_addressstring-Default gateway IP address in nnn.nnn.nnn.nnn format.
:SYSTem:COMMunicate:LAN:SELF:IP:GATeway 172.16.3.1
:SYSTem:COMMunicate:LAN:SELF:IP:GATeway?

Sets the subnet mask for the LAN self IP configuration. The query returns the current subnet mask in nnn.nnn.nnn.nnn format.

NameTypeValuesDescription
ip_addressstring-Subnet mask value in nnn.nnn.nnn.nnn format, with each nnn ranging from 0 to 255.
string - The current subnet mask in nnn.nnn.nnn.nnn format.
SYSTem:COMMunicate:LAN:SELF:IP:SUBMask 255.255.255.0
SYSTem:COMMunicate:LAN:SELF:IP:SUBMask?

Enable or disable the manual IP setting mode. Query the status of the manual IP setting mode.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Enables or disables the manual IP setting mode.
:SYSTem:COMMunicate:LAN:SELF:MANuip:STATe ON
:SYSTem:COMMunicate:LAN:SELF:MANuip:STATe 1
:SYSTem:COMMunicate:LAN:SELF:MANuip:STATe?

Set or query the USB device class. AUTO lets the USB main device decide the class; TMC selects Test & Measurement Class and PRINter selects Printer Class.

NameTypeValuesDescription
modeenumTMC | PRINter | AUTOUSB device class to set.
:SYSTem:COMMunicate:USB:SELF:CLASs PRINter
:SYSTem:COMMunicate:USB:SELF:CLASs?

Queries the system information of the spectrum analyzer. The returned information includes the model, serial number, software and hardware versions.

string - Returns the system information, with content and language depending on the current system language.

Query the system message displayed lately. Up to 71 history messages can be displayed.

string - Returns the system messages lately displayed. The format depends on the current system language.
:SYSTem:CONFigure:MESSage?
:SYSTem:DATEset / query

Sets the instrument date or queries the current date.

NameTypeValuesDescription
yearstring2000 - 2099Year of the instrument date.
monthstring01 - 12Month of the instrument date.
daystring01 - 31Day of the instrument date.
string - The query returns the current date in YYYY,MM,DD format.
SYSTem:DATE 2016,05,16
SYSTem:DATE?

Queries and deletes the last message in the error queue. If no error currently exists, it returns 0,"No Error".

string - Returns the error message in "Error Number,"Error Message"" format.

Enables or disables the front panel power switch. The query returns the current switch status as 0 or 1.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Enable or disable the front panel power switch.
enum - The query returns 0 or 1.
:SYSTem:FSWItch:STATe OFF or :SYSTem:FSWItch:STATe 0
:SYSTem:FSWItch:STATe?
:SYSTem:KLOCkset / query

Lock or unlock the specified function key. The query checks whether the specified key is locked.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Enable or disable key locking.
keyenumFREQ | SPAN | AMP | BW | SWEEP | TRACE | MARK | MARKFUNC | MARKTO | PEAK | TUNE | MEAS | MEASSET | DEMOD | SYSTEM | PRINTSETUP | STORAGE | PRESET | PRINT | ALLSpecifies which front-panel key or keys are affected.
enum - Returns whether the specified key is locked.
:SYSTem:LANGuageset / query

Set or query the instrument language.

NameTypeValuesDescription
languageenumENGLish | CHINese | JAPan | PORTugese | GERMan | POLish | KORea | TCHineseLanguage to set.
enum - The query returns ENGL, CHIN, JAP, PORT, GERM, POL, KOR or TCHinese.
:SYSTem:LANGuage CHINese
:SYSTem:LANGuage?

Queries the status of line mode.

integer - Returns 0 for non-line mode or 1 for line mode.
:SYSTem:LINemod:STATe?
:SYSTem:LINemod:STATe?

Sets the preset setting used in line mode, or exits line mode.

NameTypeValuesDescription
modeenumFACTory | USER1 | USER2 | USER3 | USER4 | USER5 | USER6 | OFFPreset setting used in line mode, or OFF to exit line mode.
::SYSTem:LINemod:TYPe USER4
:SYSTem:LKEYset / query

Install and activate the specified option. The query returns the serial number of the specified option.

NameTypeValuesDescription
license keystring-ASCII license key used to install and activate an option.
:SYSTem:LKEY UADEYSACMA6RJACQTAWJZLLPBCVA
:SYSTem:LKEY? 0001

Query the option status of the spectrum analyzer, including the option number, order number, type, and activation status.

string - Returns the option status of the spectrum analyzer, including the option number, order number, type, and activation status. The returned entries are shown in the format Serial NO.|Option|Option Type|Active.
:SYSTem:PON:TYPEset / query

Sets which setting the instrument recalls at power-on, either the preset setting or the last setting. The query reports the current power-on recall setting.

NameTypeValuesDescription
modeenumPRESet | LASTPower-on recall setting.
enum - Returns the setting recalled at power-on.
:SYSTem:PON:TYPE LAST
:SYSTem:PON:TYPE?
:SYSTem:PRESetset / query

Recall the preset setting of the system to restore the instrument to the state specified by the :SYSTem:PRESet:TYPE command.

Save the user setting. This command is only available when USER1 through USER6 is selected using the :SYSTem:PRESet:TYPE command.

NameTypeValuesDescription
typeenumUSER1 | USER2 | USER3 | USER4 | USER5 | USER6Selects which user preset file to save.
namestring-The file name to be saved, excluding path and suffix.
:SYSTem:PRESet:SAVE USER2,def2

Sets the system preset type to the factory preset or one of the user presets USER1 to USER6. The query returns the current preset type.

NameTypeValuesDescription
modeenumFACTory | USER1 | USER2 | USER3 | USER4 | USER5 | USER6Preset type to select.
:SYSTem:PRESet:TYPe USER5
:SYSTem:PRESet:TYPe?

Enable or disable the earphone in demodulation. This command is only available when AM or FM demodulation is enabled.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Turns the earphone off or on.
::SYSTem:SPEaker:STATe ON or :SYSTem:SPEaker:STATe 1
::SYSTem:SPEaker:STATe?

Set or query the volume of the earphone in demodulation. This command is only available when AM or FM demodulation is enabled.

NameTypeValuesDescription
integerinteger0 - 255Volume setting for the earphone in demodulation.
:SYSTem:TIMEset / query

Sets the instrument time, or queries the current instrument time.

NameTypeValuesDescription
hourstring00 - 23Hour of the time to set.
minutestring00 - 59Minute of the time to set.
secondstring00 - 59Second of the time to set.
string - The current time in HH,MM,SS format.
:SYSTem:TIME 15,10,30
:SYSTem:TIME?

Query the connection status of TX1000.

enum - Returns 0 or 1 indicating the connection status of TX1000.
:SYSTem:TX:SWsetset / query

Sets the on/off status of one TX1000 switch. This command is only available when TX1000 is connected.

NameTypeValuesDescription
switchenumSW1 | SW2 | SW3 | SW4 | SW5Selects which TX1000 switch to control.
stateenumOFF | ON | 0 | 1Sets the selected switch off or on.
::SYSTem:TX:SWset SW1,ON
::SYSTem:TX:SWset SW1,1

Queries the on/off status of a selected TX1000 switch. The command is only available when TX1000 is connected.

NameTypeValuesDescription
switchenumSW1 | SW2 | SW3 | SW4 | SW5Selects one of the five TX1000 switches.
enum - Returns the on/off status as 0 or 1.

Confirms and validates the UserKey definition. The definition is only valid when UserKey is enabled and after the defining command has been sent.

Defines a related function for UserKey, or queries the functions currently related to UserKey. The definition is only valid when UserKey is enabled and after the defining command is sent.

NameTypeValuesDescription
<key_value>enumFREQ | SPAN | AMP | BW | SWEep | TUNE | DEMod | TRACe | MEAS | MEASset | MARK | MARKfunc | MARKto | PEAK | PRESet | SYSTem | STORage | PRINt | PRINtsetup | HELP | F1 | F2 | F3 | F4 | F5 | F6 | F7 | RETUrn | PAGEdownRelated function assigned to a UserKey.
enum - Returns the functions currently related to UserKey as a list of keywords.
:SYSTem:USERkey:STATe ON
:SYSTem:USERkey:KEYCmd SYSTem,PAGEdown,F2,F2
:SYSTem:USERkey:CONFirm
:SYSTem:USERkey:KEYCmd?

Enable or disable the UserKey setting. The query returns the current UserKey status.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Sets the UserKey setting state.
enum - Returns the status of the UserKey setting.
:SYSTem:USERkey:STATe ON or :SYSTem:USERkey:STATe 1
:SYSTem:USERkey:STATe?

Query the SCPI version of the instrument.

string - The SCPI version.

Set the number of averages of the trace. The query returns the number of averages of the trace.

NameTypeValuesDescription
integerinteger1 - 1000Number of trace averages to use.

Query the number of averages currently executed of the trace.

integer - The number of averages currently executed of the trace.

Execute the trace average reset operation. This command is valid when the trace type is set to "Video Avg" or "Power Avg".

:TRACe:CLEar:ALLset / query

Clear all the traces by setting the type of all traces to BLANK (Off).

:TRACe[:DATA]set / query

Loads user data into the specified trace, or queries the data of the specified trace. The query response format depends on the :FORMat[:TRACe][:DATA] setting.

NameTypeValuesDescription
traceenumTRACE1 | TRACE2 | TRACE3 | TRACE4Specifies which trace to access.
datablock-User data to load, provided as either a definite-length block or comma-separated ASCII data.
:TRACe:DATA TRACE1,#9000009014 -1.390530e+01, -7.108871e+01, -7.089631e+01, -6.992984e+01, -7.010770e+01, ……
:TRACe:DATA? TRACE1
:TRACe:DATA
TRACE2,#9000002404111111111111111111111111111001111111111111111111111111111101110
111111111111111111111111111111111111010011……
:TRACe:DATA? TRACE2
:TRACe:MATH:Aset / query

Sets A in the trace math expression to trace 1, trace 2, or trace 3. The query returns which trace is currently represented by A.

NameTypeValuesDescription
modeenumT1 | T2 | T3Trace selection for A in the trace math expression.
enum - Returns the trace assigned to A in the trace math expression.
:TRACe:MATH:A T2
:TRACe:MATH:A?
:TRACe:MATH:Bset / query

Set B in the trace math expression to denote trace 1, trace 2 or trace 3. Query the trace represented by B in the trace math expression.

NameTypeValuesDescription
--enumT1 | T2 | T3Selects trace 1, trace 2, or trace 3.

Sets or queries the constant used in the trace math expression.

NameTypeValuesDescription
integerreal-300 dB - 300 dBConsecutive real number constant for the trace math expression.
string - The constant in scientific notation.
:TRACe:MATH:CONSt 50
:TRACe:MATH:CONSt?

Queries the frequencies and amplitudes of the peaks in the peak table. This command only queries trace 1.

block - Returns the peak-table data as frequency/amplitude pairs, up to 10 frequencies and amplitudes, in the format shown in the example.

Query the number of peaks in the peak table.

integer - The number of peaks in the peak table.

Set or query the sorting rule of the peak table.

NameTypeValuesDescription
sorting ruleenumAMPLitude | FREQuencySorting rule for the peak table.
:TRACe:MATH:PEAK:SORT AMPLitude
:TRACe:MATH:PEAK:SORT?

Enable or disable the peak table. Query the status of the peak table.

NameTypeValuesDescription
statebooleanOFF | ON | 0 | 1Sets the peak table state.
integer - The query returns 0 or 1.

Sets or queries the display mode of the peak in the peak table.

NameTypeValuesDescription
modeenumNORMal | DLMore | DLLessDisplay mode for the peak table.
enum - The query returns the current display mode of the peak in the peak table.
:TRACe:MATH:PEAK:THReshold NORMal
:TRACe:MATH:PEAK:THReshold?

Enable or disable the math operation of the trace. Query the status of the math operation of the trace.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Turns the trace math operation off or on.
:TRACe:MATH:TYPEset / query

Set or query the operation type of the trace.

NameTypeValuesDescription
modeenumA-B | A+CONST | A-CONSTOperation type of the trace.
enum - The query returns the trace operation type.
:TRACe:MATH:TYPE A+CONST
:TRACe:MATH:TYPE?

Set the average type of trace <n>. Query the average type of trace.

NameTypeValuesDescription
noptdiscrete1 - 3Trace number.
modeenumVIDeo | RMSAverage type for the trace.
enum - Returns the average type of the trace.
:TRACe<n>:AVERage:TYPE VIDeo|RMS
:TRACe<n>:AVERage:TYPE?
:TRACe<n>:MODEset / query

Sets the type of the specified trace, or queries the type of the specified trace. The query returns WRIT, MAXH, MINH, VIEW, BLANK, VID, or POW.

NameTypeValuesDescription
ndiscrete1 - 3Trace number.
modeenumWRITe | MAXHold | MINHold | VIEW | BLANk | VIDeoavg | POWeravgTrace mode.
enum - Returns the current trace mode.
:TRACe1:MODE VIDeoavg
:TRACe1:MODE?

Queries whether the current trigger is ready. This command is valid only when the external trigger is selected.

integer - 1 indicates the trigger is ready; 0 indicates the trigger is being prepared.

Sets the trigger edge of the external trigger and queries the current external trigger edge.

NameTypeValuesDescription
modeenumPOSitive | NEGativeTrigger edge for the external trigger.
:TRIGger:SEQuence:EXTernal:SLOPe POSitive
:TRIGger:SEQuence:EXTernal:SLOPe?

Sets or queries the trigger type for the trigger sequence source. The available source types are Immediate, Video, and External.

NameTypeValuesDescription
sourceenumIMMediate | VIDeo | EXTernalTrigger source type to set.
enum - Returns the current trigger type as IMM, VID, or EXT.
:TRIGger:SEQuence:SOURce EXTernal
:TRIGger:SEQuence:SOURce?

Sets the trigger level for video trigger. The query returns the trigger level in scientific notation.

NameTypeValuesDescription
amplreal-300 - 50Consecutive real number specifying the video trigger level.
real - Returns the trigger level in scientific notation.
:TRIGger:SEQuence:VIDeo:LEVel 10
:TRIGger:SEQuence:VIDeo:LEVel?

:UNIT:POWerset / query

Sets or queries the unit of the Y axis. The default log unit is dBm and the default linear unit is V.

NameTypeValuesDescription
unitenumDBM | DBMV | DBUV | V | WSelects the Y-axis unit.
enum - Returns the current Y-axis unit.
:UNIT:POWer W
:UNIT:POWer?