/

Rigol

/

Rigol DSA815-TG

SCPI COMMAND REFERENCE

Rigol DSA815-TG

Rigol DSA815-TG

The Rigol DSA815-TG is Rigol's spectrum analyzer in the DSA800 Series family. Its SCPI remote-control interface exposes 261 commands across 22 subsystems - 187 settable and 74 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.

261

Commands

187

Settable

74

Queries

22

Subsystems

SCPI

Verified

2026-07-16

All commands

:ABORtset / query

Gives up the current operation and restarts the sweep.

Sets the value of N in N dB bandwidth measurement, and the query returns the current N value in scientific notation.

NameTypeValuesDescription
rel_amplreal-100 - 100Relative amplitude value for the N dB bandwidth measurement.
real - Returns the value of N in scientific notation.
:CALCulate:BANDwidth:NDB -4
:CALCulate:BANDwidth:NDB?

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

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

Sets the X axis of the Pass/Fail test to frequency or time. The setting applies to both the upper and lower limit lines, and changing it 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.

numeric - Returns the fail ratio in scientific notation.
:CALCulate:LLINe:FAIL:RATIo?

Sets whether the test stops when the test fails. The query returns 0 or 1 indicating the current stop-test-on-fail state.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Whether to stop the test if the test fails.
enum - Returns 0 or 1.
: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 test limit line to logarithmic or linear. The query returns the current interpolation mode.

NameTypeValuesDescription
ndiscrete1 - 2Denotes the lower limit line (1) or upper limit line (2).
modeenumLOGarithmic | LINearSelects the interpolation mode.
enum - Returns the current 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 - 7.5 GHzThe frequency or time of the point being edited, depending on the X axis type.
amplreal-400 dBm - 320 dBmThe amplitude of the point being edited.
connecteddiscrete0 - 1Indicates whether the point is connected.

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

NameTypeValuesDescription
ninteger1 - 2Denotes the lower limit line (1) or upper limit line (2).
x-axisreal0 - 7.5Frequency or time of the point being edited, depending on the X axis type.
x-axisreal0 - 7.5Frequency or time of the point being edited, depending on the X axis type.
amplreal-400 - 320Amplitude of the point being edited.
connectedenum0 | 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 | 1Enables or disables the REL Amplitude.
integer - Returns the REL Amplitude status as 0 or 1.
:CALCulate:LLINe1:RELAmpt:STATe ON or :CALCulate:LLINe1:RELAmpt:STATe 1
:CALCulate:LLINe1:RELAmpt?

Enables or disables REL Frequency for a specified limit line. The query returns the current REL Frequency status as 0 or 1.

NameTypeValuesDescription
ninteger1 - 2Denotes the lower limit line (1) or upper limit line (2).
stateenumOFF | ON | 0 | 1Turns REL Frequency off or on.
integer - Returns the REL Frequency status as 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
<n>integer1 - 2Denotes the lower limit line (1) or upper limit line (2).
stateenumOFF | ON | 0 | 1Turns the limit line on or off.
enum - The query returns 0 or 1.
:CALCulate:LLINe1:STATe ON or :CALCulate:LLINe1:STATe 1
:CALCulate:LLINe1:STATe?

Disables all currently enabled markers as well as all marker-based functions.

Sets the resolution of the frequency counter, or queries the current resolution setting. The resolution can be specified in discrete frequency values and may be entered in number or number+unit form.

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

Sets the resolution of the frequency counter to be adjusted automatically, and queries the auto-setting status. The query returns 0 or 1.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Controls whether auto resolution is disabled or enabled.
enum - Returns 0 or 1 indicating the auto setting status.
:CALCulate:MARKer:FCOunt:RESolution:AUTO OFF or :CALCulate:MARKer:FCOunt:RESolution:AUTO 0
:CALCulate:MARKer:FCOunt:RESolution:AUTO?

Queries the reading of the frequency counter. When the frequency counter is disabled, it returns 9000000000000000.

integer (Hz) - The reading of the frequency counter in Hz.

Enable or disable the frequency counter. The query reports the status of the frequency counter.

NameTypeValuesDescription
stateoptenumOFF | ON | 0 | 1Enables or disables the frequency counter.
enum - Returns 0 or 1 indicating the frequency counter status.
: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. Queries the status of continuous peak search.

NameTypeValuesDescription
ndiscrete1 - 4Marker number.
stateoptenumOFF | ON | 0 | 1Enables or disables continuous peak search.

Sets the center frequency of the spectrum analyzer to the frequency difference of the specified Delta, Delta Pair, or Span Pair marker.

NameTypeValuesDescription
ninteger1 - 4Marker number.

Set the span of the spectrum analyzer to the frequency difference of the specified Delta, Delta Pair or Span Pair marker. The command is not available in zero span mode.

NameTypeValuesDescription
ninteger1 - 4Specifies the marker number to use.
:CALCulate:MARKer1:DELTa:SET:SPAN

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

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

Search and mark the nearest peak located at the left side of the current peak on the trace, provided it meets the peak search condition.

NameTypeValuesDescription
<n>discrete1 - 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 located to the right of the current peak that meets the peak search condition.

NameTypeValuesDescription
ndiscrete1 - 4Marker number.

Search and mark the peak on the trace with the minimum amplitude.

NameTypeValuesDescription
ninteger1 - 4Specifies the marker number.

Sets the type of the specified marker, or queries the current marker type. The query returns POS, DELT, BAND, or SPAN.

NameTypeValuesDescription
ninteger1 - 4Specifies the marker number.
modeenumPOSition | DELTa | BAND | SPANSelects the marker type.
enum - Returns the current 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 - 4Marker number.
rel_amplreal0 - 200Peak excursion value.
real (dB) - The peak excursion value in scientific notation.
:CALCulate:MARKer1:PEAK:EXCursion 12
:CALCulate:MARKer1:PEAK:EXCursion?

Set the peak search mode. Query the peak search mode.

NameTypeValuesDescription
<n>discrete1 - 4
modeenumPARameter | MAXimumSearch mode: parameter conditions or maximum on the trace.
enum - Returns the peak search mode as PAR or MAX.
:CALCulate:MARKer1:PEAK:SEARch:MODE PARameter|MAXimum
:CALCulate:MARKer1:PEAK:SEARch:MODE?

Execute a peak search, mark the peak using the specified marker, and set the spectrum analyzer center frequency to the current peak frequency.

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

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

NameTypeValuesDescription
ndiscrete1 - 4
amplreal-200 - 0Peak threshold value.
real (dBm) - The query returns 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.

NameTypeValuesDescription
ndiscrete1 - 4Specifies which marker to use.
:CALCulate:MARKer1:PTPeak

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

NameTypeValuesDescription
ndiscrete1 - 4Specifies which marker is used.
:CALCulate:MARKer1:SET:CENTer

Sets the spectrum analyzer reference level to the amplitude of the specified marker. If the specified marker is a Normal marker, the reference level is set to that marker's amplitude; for Delta, Delta Pair, or Span Pair markers, it uses the delta marker amplitude.

NameTypeValuesDescription
ndiscrete1 - 4Specifies the marker number to use.

Set the start 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 - 4Specifies which marker 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 - 4Marker number to use.
:CALCulate:MARKer4:SET:STEP

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

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

Enable or disable the specified marker, or query its status. If the marker is not enabled, enabling it sets it to Normal marker (POSition).

NameTypeValuesDescription
ndiscrete1 - 4Specifies the marker number.
stateenumOFF | ON | 0 | 1Enables or disables the specified 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 trace number marked by the marker, or the trace number currently selected when set to Auto.

NameTypeValuesDescription
ndiscrete1 - 4Marker number.
integerdiscrete1 - 4Trace number to select for the specified marker.
integer - Returns the marker trace number, 1 through 4. If the marker trace is set to Auto, returns the number of the trace marked by the marker.
:CALCulate:MARKer1:TRACe 1
:CALCulate:MARKer1:TRACe?

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

NameTypeValuesDescription
ndiscrete1 - 4Marker number.
stateenumOFF | ON | 0 | 1Turns Auto marker trace selection off or on.
enum - Returns whether Auto is disabled or enabled.
:CALCulate:MARKer1:TRACe:AUTO ON or :CALCulate:MARKer1:TRACe:AUTO 1
:CALCulate:MARKer1:TRACe:AUTO?

Query the reflection coefficient at the specified marker.

NameTypeValuesDescription
ninteger1 - 4
real - The reflection coefficient in scientific notation.
:CALCulate:MARKer1:VSRefl?

Query the VSWR at the specified marker.

NameTypeValuesDescription
ndiscrete1 - 4Marker number to query.
numeric - The query returns the VSWR in scientific notation.
:CALCulate:MARKer1:VSValue?

Sets the X-axis value of the specified marker; the default unit is Hz. The query returns the marker X-axis value, formatted as an integer in frequency/reciprocal-time mode or in scientific notation in time/period mode.

NameTypeValuesDescription
ndiscrete1 - 4Marker number to select.
paramreal-X-axis value to set within the currently available X-axis range.
numeric - Returns the X-axis value of the specified marker; in frequency or reciprocal-of-time mode the value is returned as an integer, and 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-Consecutive real number within the currently available X-axis range.
real (Hz) - Returns the X-axis center value of the 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 seconds.
: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 control.
integerinteger0 - 600Sets the marker position.
integer - The position of the marker.
:CALCulate:MARKer1:X:POSition 100
:CALCulate:MARKer1:X:POSition?

Sets the center position of the specified Span Pair marker. Queries return the center position of the specified marker in integer.

NameTypeValuesDescription
ndiscrete1 | 2 | 3 | 4Specifies the marker number.
paraminteger0 - 600Sets the center position.
integer - The query returns the center position of the specified marker in integer.
: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 in integer form.

NameTypeValuesDescription
ndiscrete1 | 2 | 3 | 4Selects the marker number.
paraminteger0 - 600Number of points corresponding to the span.
integer - The query returns 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 | 2 | 3 | 4
paraminteger0 - 600
:CALCulate:MARKer1:X:POSition:STARt 100
:CALCulate:MARKer1:X:POSition:STARt?

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

NameTypeValuesDescription
ndiscrete1 | 2 | 3 | 4Specifies the marker number.
paraminteger0 - 600Position of the delta marker.
integer - Returns the position of the delta marker.
:CALCulate:MARKer1:X:POSition:STOP 300
:CALCulate:MARKer1:X:POSition:STOP?

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

NameTypeValuesDescription
ndiscrete1 - 4Marker number.
modeenumFREQuency | TIME | ITIMe | PERiodReadout mode for the marker X axis.
enum - Returns the current X-axis readout mode as one of FREQ, TIME, ITIM, or PER.
:CALCulate:MARKer1:X:READout TIME
:CALCulate:MARKer1:X:READout?

Sets the X value corresponding to the span of the specified Span Pair marker, and queries that X value. The query returns the span X value in Hz when the readout mode is frequency, or in scientific notation in seconds when the readout mode is time or period.

NameTypeValuesDescription
ndiscrete1 - 4Specifies the marker number.
paramreal-X-axis value for the span of the marker; must be within the currently available X-axis range.
real (Hz) - Returns the X value of the span of the marker. In frequency readout mode, the value is returned as an integer in Hz; in time or period readout mode, it is returned in scientific notation in seconds.
:CALCulate:MARKer1:X:SPAN 500000000
:CALCulate:MARKer1:X:SPAN?

Sets the X value of the reference marker of the specified Delta Pair marker, and queries that same X value.

NameTypeValuesDescription
ndiscrete1 - 4Specifies the marker number.
paramreal-Sets the X value within the currently available X-axis range.
real - Returns the X value of the reference marker of the specified Delta Pair marker.
:CALCulate:MARKer1:X:STARt 500000000
:CALCulate:MARKer1:X:STARt?

Sets or queries the X value of the delta marker for the specified Delta Pair marker. The allowed value depends on the current readout mode and must be within the current X-axis range.

NameTypeValuesDescription
ndiscrete1 - 4Specifies the Delta Pair marker number.
paramreal-Consecutive real number within the currently available X-axis range.
:CALCulate:MARKer1:X:STOP 350000000
:CALCulate:MARKer1:X:STOP?

Query the Y-axis value of the specified marker. For a normal marker it returns the marker Y value; for Delta, Delta Pair, or Span Pair markers it returns the Y-axis difference between the reference and delta marker.

NameTypeValuesDescription
ndiscrete1 - 4Specifies the marker number.
real (dBm) - 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 as 0 or 1.

NameTypeValuesDescription
statebooleanOFF | ON | 0 | 1Enables or disables the marker table.

Enables or disables signal track. The query returns the current status of signal track.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Turns signal track off or on.
enum - Returns the signal track status.

Enable or disable normalization. Query the status of normalization.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Enables or disables normalization.
The command below enables normalization. :CALCulate:NTData:STATe ON or :CALCulate:NTData:STATe 1
The query below returns 1. :CALCulate:NTData:STATe?

Execute self-calibration immediately.

The command below makes the instrument execute self-calibration immediately.
:CALibration:ALL

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

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Enables or disables auto calibration.
:CALibration:AUTO ON or :CALibration:AUTO 1
:CALibration:AUTO?

Query the current measurement function.

enum - Returns the current measurement function.

Sets the spectrum analyzer to the adjacent 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 channel power measurement state. This command 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. This command stops the current measurement and sets the instrument to the default state of the specified measurement.

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. The 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 whether coupling linked setting is enabled. The query returns ALL or NONE.

NameTypeValuesDescription
modeenumALL | NONESelects whether coupling linked setting is enabled for related parameters.
enum - Returns the coupling linked setting status.
: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 on the screen.
enum - The query returns BOTT, CENT or TOP.
:DISPlay:AFUnction:POSition CENTer
:DISPlay:AFUnction:POSition?

Enables or disables the display of the time and date.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Turns the clock annotation display off or on.
N/A

Set the screen brightness. Query the screen brightness.

NameTypeValuesDescription
integerinteger1 - 10
integer - The query returns the brightness in integer.
:DISPlay:BRIGhtness 6
:DISPlay:BRIGhtness?
:DISPlay:ENABleset / query

Set the on/off state of the screen. Queries the on/off state of the screen.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Selects the screen on/off state.
:DISPlay:ENABle OFF or :DISPlay:ENABle 0
:DISPlay:ENABle?

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

NameTypeValuesDescription
statebooleanOFF | ON | 0 | 1Turns message display off or on.
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 UserKey definition display.
enum - Returns 0 or 1 indicating the UserKey definition display status.
:DISPlay:UKEY:STATe ON or :DISPlay:UKEY:STATe 1
:DISPlay:UKEY:STATe?

Sets or queries the brightness of the screen grid.

NameTypeValuesDescription
integerinteger0 - 10Brightness level of the screen grid.
integer - The query returns the brightness of the screen grid in integer.
:DISPlay:WINdow:TRACe:GRATicule:GRID 2
:DISPlay:WINdow:TRACe:GRATicule:GRID?

Sets the scale type of the X-axis. The query returns the X-axis scale type.

NameTypeValuesDescription
modeenumLINear | LOGarithmicSelects the X-axis scale type.
enum - Returns the X-axis scale 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. The query returns the position of the display line in scientific notation.

NameTypeValuesDescription
amplrealdBmConsecutive real number specifying the display line position within the current amplitude range.
real - Returns the position of the display line in scientific notation.
:DISPlay:WINdow:TRACe:Y:DLINe -10
:DISPlay:WINdow:TRACe:Y:DLINe?

Enable or disable the display line. Queries the status of the display line.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Enables or disables the display line.
integer - Returns 0 or 1 for the display line status.

Sets the reference level of normalization. The query returns the reference level of normalization in scientific notation.

NameTypeValuesDescription
rel_amplreal-200 dB - 200 dBReference level of normalization.
real - The reference level of normalization in scientific notation.
:DISPlay:WINdow:TRACe:Y:SCALe:NRLevel -20
:DISPlay:WINdow:TRACe:Y:SCALe:NRLevel?

Set or query the reference position of normalization.

NameTypeValuesDescription
integerinteger0% - 100%Reference position of normalization.
numeric - The query returns the reference position of normalization in scientific notation.

Sets the Y-axis scale. The query returns the Y-axis scale in scientific notation.

NameTypeValuesDescription
rel_amplreal0.1 - 20Y-axis scale value.
real - The Y-axis scale in scientific notation.
:DISPlay:WINdow:TRACe:Y:SCALe:PDIVision 15
:DISPlay:WINdow:TRACe:Y:SCALe:PDIVision?

Set the reference level for the display trace Y scale. The query returns the reference level in scientific notation.

NameTypeValuesDescription
<ampl>real-100 - 20Reference level value to set.

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

NameTypeValuesDescription
rel_amplreal-300 - 300Reference level offset.
real (dB) - 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. The scale can be linear or logarithmic.

NameTypeValuesDescription
modeenumLINear | LOGarithmicSelects the Y-axis scale spacing.
enum - The query returns the current Y-axis scale spacing 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 the data 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 in dBc, lower channel power, and lower-channel power difference in dBc.
:FETCh:ACPower?

Query the lower channel power of adjacent channel power measurement. It selects data from the latest measurement results 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 return value is taken from the latest measurement results and is reported in the current Y-axis unit.

real - The main channel power in scientific notation, using the same unit as the current Y-axis unit.
*none provided in slice*

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, with the power unit the same as the current Y-axis unit.
:FETCh:ACPower:UPPer?

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

numeric - Returns the channel power and the power spectral density in scientific notation, separated by a comma.
:FETCh:CHPower?

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

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

Query the channel power spectral density. It returns data from the latest measurement results in scientific notation, using the current Y-axis unit for the power unit.

real - 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 - Returns the carrier power, noise power, and C/N ratio in scientific notation, separated by commas. The C/N ratio is in dB, and the power units match the current Y-axis unit.
:FETCh:CNRatio?

Query the carrier power. It is only available when the C/N ratio measurement is enabled and returns data from the latest measurement results.

real - Returns the carrier power in scientific notation.
:FETCh:CNRatio:CARRier?

Query the C/N ratio. It is only available when the C/N ratio measurement is enabled, and returns the latest measured C/N ratio from the output buffer.

real - The C/N ratio in scientific notation.
:FETCh:CNRatio:CNRatio?
The query below returns 8.956909E-02.
:FETCh:CNRatio:CNRatio?

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

real - Returns the 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 the data to the output buffer.

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

Query the amplitudes of the first 10 harmonics; the first harmonic is the fundamental waveform. This command is only available when harmonic distortion measurement is enabled and returns data from the latest measurement results.

numeric (same as current Y-axis unit) - Returns the amplitudes of the first 10 harmonics in scientific notation, separated by commas. If fewer than 10 harmonics are under measurement, unmeasured harmonics have no return values.
:FETCh:HARMonics:AMPLitude:ALL?

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

real - The percentage of the total harmonic distortion, returned in scientific notation.
no example line provided in the slice for this exact mnemonic

Queries the frequencies of the first 10 harmonics, with the first harmonic treated as the fundamental waveform. The command is only available when harmonic distortion measurement is enabled and returns data from the latest measurement results.

integer (Hz) - Returns the frequencies of the first 10 harmonics in comma-separated integer form. If fewer than 10 harmonics are being measured, unmeasured harmonics are omitted from the response.
:FETCh:HARMonics:FREQuency:ALL?

Query the frequency of the fundamental waveform. It is equivalent to :FETCh:HARMonics:FREQuency? 1 and returns data from the latest measurement results when harmonic distortion measurement is enabled.

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

Query the results of occupied bandwidth measurement. It is only available when occupied bandwidth measurement is enabled and returns data from the latest measurement results.

integer (Hz) - Returns the occupied bandwidth (Hz) and the transmit frequency error (Hz) as integers, separated by a comma.
":FETCh:OBWidth?" returns 1860000,20000.

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

integer (Hz) - Returns the occupied bandwidth in Hz.
:FETCh:OBWidth:OBWidth?

Query the transmit frequency error. It is only available when occupied bandwidth measurement is enabled, and returns data from the latest measurement results.

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

Queries the results of the TOI measurement. It selects data from the latest measurement results and transmits the TOI 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 Third Order Lower and Third Order Upper intercepts. It returns data from the latest TOI measurement results and is only available when TOI measurement is enabled.

real - Returns the minor one in scientific notation.
":FETCh:TOIntercept:IP3?" returns -8.131735E+01.

Query the result of T-power measurement. This command is only available when the T-power measurement is enabled; it selects data from the latest measurement results and transmits the data to the output buffer.

real - The T-power measurement result in scientific notation. The return unit is the same as the current Y-axis unit.
.FETCh:TPOWer?

:FORMat:BORDerset / query

Sets the byte order of binary data transmission, or queries the current byte order. NORMal uses MSB-first transmission; SWAPped uses LSB-first transmission.

NameTypeValuesDescription
modeenumNORMal | SWAPpedByte order of binary data transmission.
:FORMat:BORDer NORMal
:FORMat:BORDer?

Set or query 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 queries the current print color state.

NameTypeValuesDescription
stateoptenumOFF | ON | 0 | 1Selects gray or color mode for print output.
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?

Set the image type of the print to default or Exif/JPEG.

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

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

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Enables or disables inverted print.
integer - 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
statebooleanOFF | ON | 0 | 1Enables or disables date print.
integer - Returns the date print status as 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 orientation to landscape or portrait. Query the print orientation.

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

Sets the number of print copies. The query returns the current print copies in integer form.

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

Sets the page size of the print. The query returns the current page size.

NameTypeValuesDescription
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

Sets or queries the enable register for the standard event status register.

NameTypeValuesDescription
valueinteger0 - 255Value of the enable register. Bits 1 and 6 are always treated as 0; bits 2, 3, 4, and 7 are reserved.
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 identification 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 query checks whether the current operation is finished and returns 1 if it is finished, otherwise 0.

integer - Returns 1 if the current operation is finished; otherwise returns 0.
*OPC
*OPC?
*RSTset / query

Restore the instrument to its default state.

*SREset / query

Sets or queries the enable register for the status byte register. The value is limited to decimal numbers whose bit 0 and bit 1 are 0.

NameTypeValuesDescription
valueinteger0 - 255Enable-register value written to the status byte register.
integer - The query returns an integer equal to the sum of the weights of all bits that have already been set in the register.
*SRE 16
*SRE?
*STB?query

Query the event register for the status byte register. The return is the decimal sum of the weights of all bits set in the register; 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. Bit 0 and bit 1 are always 0, so the value ranges from 0 to 255.
*STB?
*TRGset / query

Trigger a sweep or measurement immediately.

*TST?query

Queries whether the self-check operation is finished.

integer - Returns the result of the self-check operation.
*WAIset / query

Wait for the operation to finish.

Selects continuous or single sweep/measurement mode depending on whether the instrument is in non-measurement or measurement state. The query returns the current sweep or measurement mode as 0 or 1.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Selects continuous (ON|1) or single (OFF|0) mode.
enum - Returns the sweep or measurement mode as 0 or 1.
: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 set to 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

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

:INPut:IMPedanceset / query

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

NameTypeValuesDescription
modediscrete50 | 75Input impedance value.
discrete (Ω) - Returns the input impedance setting.
:INPut:IMPedance 75
:INPut:IMPedance?

:MMEMory:DELeteset / query

Deletes the file with the specified filename. The path and filename must be included; 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.

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

Load the specified .cbl correction file and execute amplitude correction. The file name should include the path and filename, and the operation fails if the file does not exist.

NameTypeValuesDescription
modeenumANTenna | CABLe | OTHer | USERSpecifies the type of correction file to load.
file_namestring-ASCII string containing the path and filename of the correction file.
: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 .lim file to load.
:MMEM:LOAD:LIM D:\Limit1:upp1.lim

Load the stored marker table file (.mkr) into the instrument.

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

Load the specified setup file (.set).

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

Loads the specified state file (.sta). The file name should contain the path and filename, and the operation fails if the file does not exist.

NameTypeValuesDescription
file_namestring-ASCII string containing the path and filename of the state file.
:MMEMory:LOAD:STATe 1,D:\State0:default.sta

Loads the specified trace file (.trc). The file name should contain the path and the filename; 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>. The command fails if the specified file does not exist.

NameTypeValuesDescription
file_name1string-Path and filename of the source file.
file_name2string-Path and filename of the new file name.
:MMEM:MOVE E:\file1.bmp, E:\file2.bmp

Saves the amplitude correction data file with the specified filename. The file extension is .cbl or .csv; the .csv format can only be stored on the E disk.

NameTypeValuesDescription
modeenumANTenna | CABLe | OTHer | USERSelects the amplitude correction file type to save.
file_namestring-Path and filename of the correction file to save.
:MMEMory:STORe:CORRection ANT,D:\Corr1:ANT.cbl

Save the limit line currently edited with the specified filename (.lim). The file path and filename can be on the D disk or E disk, and an existing file will be overwritten.

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

Saves the marker table in the USB storage device with the specified filename. The file name should include the path and filename, and an existing file is overwritten.

NameTypeValuesDescription
file_namestring-Path and filename of the file to create on the USB storage device.
: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_namestring-Path and filename to store the peak table file.
:MMEMory:STORe:PTABle E:\PT1.csv

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

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

Save the current screen image in the USB storage device with the specified filename (.bmp/.jpg/.png).

NameTypeValuesDescription
file_namestring-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 and filename, and an existing file is overwritten.

NameTypeValuesDescription
<file_name>string-Path and filename for the setup file.
:MMEMory:STORe:SETUp D:\Setup1:ST1.set

Saves the current instrument state to the specified file name (.sta). If the file already exists, it is overwritten.

NameTypeValuesDescription
1integer1 - 1State index shown in the syntax line.
<file_name>string-Path and filename for the state file.
:MMEMory:STORe:STATe 1,E:\state.sta

Save the specified trace with the specified filename (.trc or .csv).

NameTypeValuesDescription
labelenumTRACE1 | TRACE2 | TRACE3 | MATH | ALLSpecifies which trace to save.
file_namestring-Specifies the path and filename for the saved trace file.
:MMEMory:STORe:TRACe TRACE1,D:\Trace1:T1.trc

:OUTPut[:STATe]set / query

Enable or disable the output of the tracking generator. Query the on/off status of the tracking generator.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Turns the tracking generator output off or on.
:OUTPut:STATe ON or :OUTPut:STATe 1
:OUTPut:STATe?

Executes an adjacent channel power measurement and returns the measurement results from the latest measurement buffer.

numeric - Returns five values in scientific notation: main channel power, upper channel power, upper-channel minus main-channel power difference in dBc, lower channel power, and lower-channel minus main-channel power difference in dBc. The power unit matches the current Y-axis unit.

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.

Executes an adjacent channel power measurement and returns the main channel power. The returned power uses the current Y-axis unit and is taken from the latest measurement results.

real - Returns the main channel power in scientific notation.

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

real - Upper channel power in scientific notation.

Execute a channel power measurement and return the measurement results.

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

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

real - Returns the channel power in scientific notation.

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

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

Execute a C/N ratio measurement and return the measurement results.

numeric - Returns the carrier power, noise power, and C/N ratio in scientific notation, separated by commas. The power unit of the return values is the same as the current Y-axis unit, and the C/N ratio is in dB.

Execute a C/N ratio measurement and return the carrier power.

real - Returns the carrier power in scientific notation from the latest measurement results. The power unit is the same as the current Y-axis unit.

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.

real - The query returns the noise power in scientific notation. The power unit of the return value is the same as the current Y-axis unit.

Execute an emission bandwidth measurement and return the measurement result. The query selects data from the latest measurement results and transmits it to the output buffer.

integer (Hz) - Returns the emission bandwidth as an integer value.

Executes a harmonic distortion measurement and returns the amplitudes of the first 10 harmonics. The amplitudes are taken from the latest measurement results and output in scientific notation, separated by commas.

real (same as current Y-axis unit) - Returns the amplitudes of the first 10 harmonics in scientific notation; if fewer than 10 harmonics are measured, unmeasured harmonics have no return values.
:READ:HARMonics:AMPLitude:ALL?

Executes a harmonic distortion measurement and returns the percentage of the total harmonic distortion. It selects data from the latest measurement results and transmits the data to the output buffer.

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

Execute a harmonic distortion measurement and return the frequencies of the first 10 harmonics. If fewer than 10 harmonics are under measurement, unmeasured harmonics do not have return values.

integer (Hz) - The query returns the frequencies in integer form, separated by commas, in Hz.

Execute a harmonic distortion measurement and return the frequency of the fundamental waveform. This command is equivalent to :READ:HARMonics:FREQuency? 1.

integer (Hz) - Returns 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 it to the output buffer.

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

Execute an occupied bandwidth measurement and return the transmit frequency error. The query selects data from the latest measurement results and transmits it to the output buffer.

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

Execute a TOI measurement and return the measurement results. The power unit of the return value is the same as the current Y-axis unit.

string - Returns the TOI measurement results as a comma-separated list of the Base Lower frequency (Hz), amplitude, the Base Upper frequency (Hz), amplitude, the 3rd Order Lower frequency (Hz), amplitude, intercept, and the 3rd Order Upper frequency (Hz), amplitude, intercept.

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

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

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

real - The T-power measurement result in scientific notation.

Sets or queries the offset of the output amplitude of the tracking generator. The offset changes the power readout of the tracking generator but does not change the actual output power.

NameTypeValuesDescription
rel_amplinteger-200 dB - 200 dBOffset of the output amplitude.
string - The offset in scientific notation.
:SOURce:CORRection:OFFSet 10
:SOURce:CORRection:OFFSet?

Sets or queries the output amplitude of the tracking generator in fixed power output mode.

NameTypeValuesDescription
amplinteger-40 dBm - 0 dBmOutput amplitude to set for the tracking generator.
real - The query returns the output amplitude in scientific notation.
:SOURce:POWer:LEVel:IMMediate:AMPLitude -10
:SOURce:POWer:LEVel:IMMediate:AMPLitude?

Sets or queries the tracking generator power output mode. Fixed mode disables the power sweep; sweep mode enables it within the sweep frequency range.

NameTypeValuesDescription
modeenumFIXed | SWEepPower output mode to use.
enum - Returns the current power output mode as FIX or SWE.
:SOURce:POWer:MODE SWEep
:SOURce:POWer:MODE?

Sets the output amplitude range of the tracking generator in fixed power output, or queries that range. This command is only available when the tracking generator is enabled and for DSA815-TG/DSA832-TG/DSA875-TG.

NameTypeValuesDescription
rel_amplinteger0 dB - 20 dBOutput amplitude range to set.
numeric - The query returns the output amplitude range in scientific notation.
:SOURce:POWer:SPAN 10
:SOURce:POWer:SPAN?

Set the start output amplitude of the tracking generator in power sweep mode. Query the start output amplitude of the tracking generator in power sweep mode.

NameTypeValuesDescription
amplinteger-40 - 0Start output amplitude.
:SOURce:POWer:STARt -10
:SOURce:POWer:STARt?

Sets the output amplitude range of the tracking generator in power sweep mode, or queries that range. It is only valid when the tracking generator is enabled and applies to DSA815-TG/DSA832-TG/DSA875-TG.

NameTypeValuesDescription
rel_amplinteger0 dB - 20 dBOutput amplitude range to set in power sweep mode.
string - The query returns the output amplitude range in scientific notation.
:SOURce:POWer:SWEep 10
:SOURce:POWer:SWEep?

Set whether to display the reference trace of normalization. Query whether to display the reference trace of normalization.

NameTypeValuesDescription
statebooleanOFF | ON | 0 | 1Whether to display the reference trace of normalization.
:SOURce:TRACe:REF:STATe ON or :SOURce:TRACe:REF:STATe 1
:SOURce:TRACe:REF:STATe?

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

integer - Returns the condition register value for the operation status register.

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

NameTypeValuesDescription
integerinteger0 - 32767Enable register value for the operation status register.

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

integer - Returns 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 - The value of the condition register of the questionable status register.

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

NameTypeValuesDescription
integerinteger0 - 32767Value of the enable register, with bits 15 and 12 to 9 forced to 0.
integer - The value of the enable register of the questionable status register.

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

integer - 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 | 1Sets the beeper state.
enum - The query returns the beeper status as 0 or 1.
SYSTem:BEEPer:STATe ON or :SYSTem:BEEPer:STATe 1
SYSTem:BEEPer:STATe?
:SYSTem:CLEarset / query

Clear all the data of user settings. After clearing, the settings are restored to factory state, including user data stored in NVRAM and NorFlash, the HOST NAME, IP address, and LXI password.

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

NameTypeValuesDescription
portenumGPIB | LAN | USB | OFFCurrent communication port to select, or OFF to disable 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. Query the current operation state of the instrument.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Sets the instrument state to local or remote mode.

Sets the GPIB address or queries the current GPIB address.

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

Enables or disables the auto IP setting mode. The query returns the current auto IP setting status as 0 or 1.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Enables or disables auto IP setting mode.
integer - Returns 0 or 1 indicating the auto IP setting mode status.
: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. Query the status of the DHCP mode.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Sets the DHCP mode state.
enum - The query returns 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.
string - The current IP address in nnn.nnn.nnn.nnn format.

Sets the DNS address for the LAN interface. The query returns the current DNS address in nnn.nnn.nnn.nnn format.

NameTypeValuesDescription
ip_addressstring-DNS server IP address in nnn.nnn.nnn.nnn format.
string - Returns the 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 IP address for the LAN interface, or queries the current default gateway. The IP 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 address in nnn.nnn.nnn.nnn format.
string - Returns the current default gateway in nnn.nnn.nnn.nnn format.
:SYSTem:COMMunicate:LAN:SELF:IP:GATeway 172.16.3.1
:SYSTem:COMMunicate:LAN:SELF:IP:GATeway?

Sets or queries the subnet mask. The subnet mask must be entered in nnn.nnn.nnn.nnn format.

NameTypeValuesDescription
ip_addressstring-Subnet mask value in nnn.nnn.nnn.nnn format.
string - Returns 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. The query returns the current status as 0 or 1.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Enables or disables manual IP setting mode.
integer - Returns 0 or 1 to indicate the current manual IP setting mode status.
:SYSTem:COMMunicate:LAN:SELF:MANuip:STATe ON
:SYSTem:COMMunicate:LAN:SELF:MANuip:STATe 1
:SYSTem:COMMunicate:LAN:SELF:MANuip:STATe?

Sets or queries 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 select.

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

string - Returns the system information in 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 language depends on the current system language.
:SYSTem:DATEset / query

Sets the instrument date or queries the current date.

NameTypeValuesDescription
yearinteger2000 - 2099Year of the instrument date.
monthinteger01 - 12Month of the instrument date.
dayinteger01 - 31Day of the instrument date.
string - Returns the current date in YYYY,MM,DD format.
:SYSTem:DATE 2014,05,16
:SYSTem:DATE?

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

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

Enable or disable the front panel power switch. The query returns the status of the front panel power switch as 0 or 1.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Sets the front panel power switch state.
enum - Returns the front panel power switch status as 0 or 1.
:SYSTem:KLOCkset / query

Locks or unlocks the specified front-panel function key. The query reports whether the specified key is locked.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Specifies whether to lock or unlock the key.
keyenumFREQ | SPAN | AMP | BW | SWEEP | TRACE | TG | MARK | MARKFUNC | MARKTO | PEAK | TUNE | MEAS | MEASSET | DEMOD | SYSTEM | PRINTSETUP | STORAGE | PRESET | PRINT | ALLSpecifies the front-panel key or keys to lock or unlock.
enum - Returns whether the specified key is locked.
:SYSTem:KLOCk OFF|0,<key>
:SYSTem:KLOCk? <key>
:SYSTem:LANGuageset / query

Sets or queries the instrument language. The query returns the current language in abbreviated form.

NameTypeValuesDescription
languageenumENGLish | CHINese | JAPan | PORTugese | GERMan | POLish | KORea | TCHineseLanguage to select for the instrument.
enum - Returns the current language as ENGL, CHIN, JAP, PORT, GERM, POL, KOR, or TCHinese.
:SYSTem:LANGuage CHINese
:SYSTem:LANGuage?

Query the status of line mode.

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

Set the preset setting used in line mode or exit line mode.

NameTypeValuesDescription
modeenumFACTory | USER1 | USER2 | USER3 | USER4 | USER5 | USER6 | OFFPreset setting used in line mode or command 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-License key to install and activate the option.
:SYSTem:LKEY UADEYSACMA6RJACQTAWJZLLPBCVA
:SYSTem:LKEY? 0001

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

string - Returns the option status of the spectrum analyzer, formatted as a table with serial number, option, option type, and active status.
:SYSTem:PON:TYPEset / query

Set the instrument to recall either the preset setting or the last setting at power-on. The query reports which setting is recalled at power-on.

NameTypeValuesDescription
modeenumPRESet | LASTPower-on recall setting.
enum - Returns the power-on recall setting as PRES or LAST.
: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 :SYSTem:PRESet:TYPE.

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

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

Sets the system preset type to Factory or one of the user preset slots USER1 through 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. The query returns the earphone status as 0 or 1.

NameTypeValuesDescription
stateoptenumOFF | ON | 0 | 1Turns the earphone off or on in demodulation.
enum - Returns the earphone status as 0 or 1.
: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 level to set for the earphone.
::SYSTem:SPEaker:VOLume 100
::SYSTem:SPEaker:VOLume?
:SYSTem:TIMEset / query

Set the time of the instrument. The query returns the current time in HH,MM,SS format.

NameTypeValuesDescription
hourinteger00 - 23
minuteinteger00 - 59
secondinteger00 - 59
:SYSTem:TIME 15,10,30
:SYSTem:TIME?

Query the connection status of TX1000.

integer - Returns 0 or 1.
:SYSTem:TX:SWsetset / query

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

NameTypeValuesDescription
switchenumSW1 | SW2 | SW3 | SW4 | SW5Selects which of the five TX1000 switches to control.
stateenumOFF | ON | 0 | 1Sets the switch state.
:SYSTem:TX:SWset SW1,ON or :SYSTem:TX:SWset SW1,1

Queries the on/off status of a specified TX1000 switch. SW1 to SW5 represent the five switches of TX1000; the command is only available when TX1000 is connected.

NameTypeValuesDescription
switchenumSW1 | SW2 | SW3 | SW4 | SW5Selects which TX1000 switch to query.
enum - Returns the on/off status as 0 or 1.

Confirms and validates the current UserKey definition. The definition is only valid when UserKey is enabled and after a defining :SYSTem:USERkey:KEYCmd command has been sent.

:SYSTem:USERkey:STATe ON :SYSTem:USERkey:KEYCmd SYSTem,PAGEdown,F2,F2 :SYSTem:USERkey:CONFirm

Defines the front-panel function(s) related to UserKey, and can query the functions currently assigned to UserKey. The definition is only valid when UserKey is enabled and after sending :SYSTem:USERkey:CONFirm.

NameTypeValuesDescription
key_valueenumFREQ | SPAN | AMP | BW | SWEep | TUNE | DEMod | TRACe | TG | MEAS | MEASset | MARK | MARKfunc | MARKto | PEAK | PRESet | SYSTem | STORage | PRINt | PRINtsetup | HELP | F1 | F2 | F3 | F4 | F5 | F6 | F7 | RETUrn | PAGEdownFront-panel key or menu control key to assign to UserKey.
enum - Returns the function currently related to UserKey as a comma-separated list of assigned key values.
:SYSTem:USERkey:KEYCmd SYSTem,PAGEdown,F2,F2
:SYSTem:USERkey:KEYCmd?

Enable or disable the UserKey setting. The query reports the current status of the UserKey setting.

NameTypeValuesDescription
statebooleanOFF | ON | 0 | 1Sets the UserKey setting state.
SYSTem:USERkey:STATe ON or :SYSTem:USERkey:STATe 1
SYSTem:USERkey:STATe?

Query the SCPI version of the instrument.

real - The query returns the SCPI version.

Set or query the number of averages of the trace.

NameTypeValuesDescription
integerinteger1 - 1000Number of trace averages.

Query the number of averages currently executed of the trace.

integer - The number of averages currently executed of the trace.
:TRACe:AVERage:COUNt:CURRent?

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; namely set the type of all the traces to BLANK (Off).

:TRACe[:DATA]set / query

Loads user data into the specified trace. The query returns the data of the specified trace, with the return format depending on the :FORMat[:TRACe][:DATA] setting.

NameTypeValuesDescription
traceenumTRACE1 | TRACE2 | TRACE3 | TRACE4Specifies which trace to load or query.
datablock-User data block, either a definite-length block or comma-separated ASCII data.
block - Returns the data of the specified trace. The returned format depends on the :FORMat[:TRACe][:DATA] setting.
:TRACe:DATA TRACE1,#9000009014 -1.390530e+01, -7.108871e+01, -7.089631e+01,
:TRACe:DATA? TRACE1
:TRACe:DATA
TRACE2,#9000002404111111111111111111111111111001111111111111111111111111111101110
:TRACe:MATH:Aset / query

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

NameTypeValuesDescription
--enumT1 | T2 | T3Selects which trace is assigned to A in the trace math expression.
enum - Returns the trace represented by A in the trace math expression.
:TRACe:MATH:A T2
:TRACe:MATH:A?
:TRACe:MATH:Bset / query

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

NameTypeValuesDescription
modeenumT1 | T2 | T3Trace selection for B in the trace math expression.
enum - Returns T1, T2, or T3.
:TRACe:MATH:B T1
:TRACe:MATH:B?

Sets the constant in the trace math expression, or queries it. The value range is -300 dB to 300 dB.

NameTypeValuesDescription
integerreal-300 - 300Consecutive real number constant used in 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.

arbitrary_block - Returns the frequencies and amplitudes of the peaks in the peak table, up to 10 frequency/amplitude pairs.
:TRACe:MATH:PEAK[:DATA]?

Queries the number of peaks in the peak table.

integer - Returns the number of peaks in the peak table.

Sets or queries the sorting rule of the peak table.

NameTypeValuesDescription
modeenumAMPLitude | FREQuencySorting rule for the peak table.
enum - Returns the current peak-table sorting rule as AMPL or FREQ.
:TRACe:MATH:PEAK:SORT AMPLitude
:TRACe:MATH:PEAK:SORT?

Enables or disables the peak table. The query returns the current peak table status.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Turns the peak table off or on.
enum - Returns the peak table status as 0 or 1.
:TRACe:MATH:PEAK:TABLe:STATe ON or :TRACe:MATH:PEAK:TABLe:STATe 1
:TRACe:MATH:PEAK:TABLe:STATe?

Sets the display mode of the peak in the peak table. Queries return the current display mode.

NameTypeValuesDescription
modeenumNORMal | DLMore | DLLessDisplay mode of the peak in the peak table.
enum - Returns the 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. The query returns the current math operation status.

NameTypeValuesDescription
stateenumOFF | ON | 0 | 1Enables or disables the math operation of the trace.
enum - Returns the status of the math operation of the trace as 0 or 1.
:TRACe:MATH:STATe ON or :TRACe:MATH:STATe 1
:TRACe:MATH:STATe?
:TRACe:MATH:TYPEset / query

Set the operation type of the trace. The query returns the current operation type.

NameTypeValuesDescription
modeenumA-B | A+CONST | A-CONSTOperation type of the trace.
enum - Returns the current trace math operation type.
:TRACe:MATH:TYPE A+CONST
:TRACe:MATH:TYPE?

Sets or queries the average type of the specified trace. Video average and power average are supported.

NameTypeValuesDescription
ndiscrete1 - 3Trace number.
typeenumVIDeo | RMSAverage type to set.
enum - Returns the current average type of the trace.
:TRACe1:AVERage:TYPE VIDeo
:TRACe1:AVERage:TYPE?
:TRACe<n>:MODEset / query

Sets or queries the type of the specified trace. The trace number <n> selects trace 1, 2, or 3.

NameTypeValuesDescription
ndiscrete1 - 3Trace number.
modeenumWRITe | MAXHold | MINHold | VIEW | BLANk | VIDeoavg | POWeravgTrace type to set.
:TRACe1:MODE VIDeoavg
:TRACe1:MODE?

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

enum - Returns 1 if the trigger is ready, or 0 if the trigger is being prepared.

Sets or queries the trigger edge of the external trigger. Positive selects a rising edge; negative selects a falling edge.

NameTypeValuesDescription
modeenumPOSitive | NEGativeTrigger edge for the external trigger.
enum - The query returns POS or NEG.
:TRIGger:SEQuence:EXTernal:SLOPe POSitive
:TRIGger:SEQuence:EXTernal:SLOPe?

Sets the trigger type or queries the current trigger type.

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

Sets the trigger level of the video trigger, or queries the current video trigger level. This command is only valid when video trigger is selected.

NameTypeValuesDescription
amplreal-300 - 50Consecutive real number specifying the trigger level.
real (dBm) - The query returns the trigger level in scientific notation.
:TRIGger:SEQuence:VIDeo:LEVel 10
:TRIGger:SEQuence:VIDeo:LEVel?

:UNIT:POWerset / query

Sets the Y-axis power unit. The query returns the current Y-axis unit.

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