Gives up the current operation and restarts the sweep.
SCPI COMMAND REFERENCE
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
Sets the value of N used in N dB bandwidth measurement. The query returns the current N value in scientific notation.
| Name | Type | Values | Description |
|---|---|---|---|
| rel_ampl | real | -100 - 100 | Consecutive real number specifying N in dB. |
: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 ----.
Delete the limit line currently edited.
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.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | FREQuency | TIME | Selects whether the X axis denotes frequency or time. |
:CALCulate:LLINe:CONTrol:DOMain TIME :CALCulate:LLINe:CONTrol:DOMain?
Query the result of the Pass/Fail test.
Queries the fail ratio of the Pass/Fail test. The query returns 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.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | 0 | 1 | Whether 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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 2 | Selects the lower limit line (1) or upper limit line (2). |
| mode | enum | LOGarithmic | LINear | Sets the interpolation mode to logarithmic or linear. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 2 | Denotes the lower limit line (1) or upper limit line (2). |
| x-axis | real | 0 Hz - 1 GHz | The frequency or time of the point being edited when the X axis uses frequency. |
| x-axis | real | 0 us - 1 ks | The frequency or time of the point being edited when the X axis uses time. |
| ampl | real | -400 dBm - 320 dBm | The amplitude of the point being edited. |
| connected | discrete | 0 - 1 | Indicates whether the point is connected to the previous point. |
In Pass/Fail test, adds points onto the limit line being edited. Up to 200 points can be edited for each limit line.
| Name | Type | Values | Description |
|---|---|---|---|
| <n> | discrete | 1 | 2 | Denotes the lower limit line (1) or upper limit line (2). |
| <x-axis> | real | 0 Hz - 1 GHz | Frequency of the point being edited when the X axis denotes frequency. |
| <x-axis> | real | 0 us - 1 ks | Time of the point being edited when the X axis denotes time. |
| <ampl> | real | -400 dBm - 320 dBm | Amplitude of the point being edited. |
| <connected> | discrete | 0 | 1 | Whether 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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 2 | Denotes 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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 2 | Denotes the lower limit line (1) or the upper limit line (2). |
| stateopt | boolean | OFF | ON | 0 | 1 | Turns REL Amplitude off or on. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 2 | Denotes the lower limit line (1) or upper limit line (2). |
| stateopt | enum | OFF | ON | 0 | 1 | Enables or disables REL Frequency. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 2 | Denotes the lower limit line (1) or upper limit line (2). |
| state | enum | OFF | ON | 0 | 1 | Turns the limit line on or off. |
Disables all currently enabled markers and all marker-based functions.
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.
| Name | Type | Values | Description |
|---|---|---|---|
| freq | enum | 1 Hz | 10 Hz | 100 Hz | 1 kHz | 10 kHz | 100 kHz | Resolution of the frequency counter. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | 0 | 1 | Enables or disables automatic resolution setting. |
:CALCulate:MARKer:FCOunt:RESolution:AUTO OFF :CALCulate:MARKer:FCOunt:RESolution:AUTO 0 :CALCulate:MARKer:FCOunt:RESolution:AUTO?
Queries the reading of the frequency counter.
Enable or disable the frequency counter. Query the status of the frequency counter.
| Name | Type | Values | Description |
|---|---|---|---|
| stateopt | enum | OFF | ON | 0 | 1 | Enables or disables the frequency counter. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 4 | Marker number. |
| stateopt | enum | OFF | ON | 0 | 1 | Enables or disables 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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 4 | Marker 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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 4 | Specifies the marker number. |
| mode | enum | NDB | NOISe | OFF | Selects the special measurement type. |
::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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 4 | Marker 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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 4 | Marker 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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 4 | Marker 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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 4 | Marker number. |
| mode | enum | POSition | DELTa | BAND | SPAN | Marker type to set. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 4 | |
| rel_ampl | real | 0 dB - 200 dB | Peak excursion value to set. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 4 | |
| mode | enum | PARameter | MAXimum | Search mode: parameter-based peak search or maximum search. |
Executes a peak search using the specified marker and sets the spectrum analyzer center frequency to the frequency of the current peak.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 4 | Marker 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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 4 | Marker number to use. |
| ampl | real | -200 dBm - 0 dBm | Peak threshold amplitude. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| <n> | discrete | 1 - 4 | Marker number to use. |
:CALCulate:MARKer1:PTPeak
Set the center frequency of the spectrum analyzer to the frequency of the specified marker.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 4 | Marker 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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 4 | Specifies which marker is used. |
:CALCulate:MARKer2:SET:RLEVel
Set the start frequency of the spectrum analyzer to the frequency of the specified marker.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 4 | Marker 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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | 3 | 4 | Specifies 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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | 3 | 4 | Specifies the marker number to use. |
:CALCulate:MARKer2:SET:STOP
Enables or disables the specified marker. The query returns the status of the specified marker.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 4 | Marker number. |
| state | enum | OFF | ON | 0 | 1 | Enable or disable the marker. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 4 | Marker number. |
| integer | integer | 1 - 4 | Trace number to select; trace 1, 2, 3, or 4 (math trace). |
:CALCulate:MARKer1:TRACe 1 :CALCulate:MARKer1:TRACe?
Set the specified marker trace to Auto. Query whether the marker trace is set to Auto.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 4 | Marker number. |
| state | boolean | OFF | ON | 0 | 1 | Enables or disables Auto for the marker trace. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 4 | Marker number. |
| param | real | - | X-axis value to set, within the range currently available of the X axis. |
:CALCulate:MARKer1:X 15000000 :CALCulate:MARKer1:X?
Sets or queries the X-axis center value of the specified Span Pair marker.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 4 | Marker number. |
| param | real | - | X-axis center value; must be within the current X-axis range. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | 3 | 4 | Specifies which marker to address. |
| integer | integer | 0 - 600 | Sets the marker position. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 4 | Specifies the marker number. |
| param | integer | 0 - 600 | Center 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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | 3 | 4 | Specifies which marker number to use. |
| param | integer | 0 - 600 | Number of points corresponding to the span. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 4 | |
| param | integer | 0 - 600 | Position 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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | 3 | 4 | Specifies which marker to use. |
| param | integer | 0 - 600 | Sets the delta marker position. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 4 | Marker number. |
| mode | enum | FREQuency | TIME | ITIMe | PERiod | X-axis readout mode. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 4 | Selects the Span Pair marker number. |
| param | real | - | X-axis value for the marker span; must be within the currently available X-axis range. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 4 | Specifies the marker number. |
| param | real | - | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | 3 | 4 | Specifies the marker number. |
| param | real | - | 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. 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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 4 | Specifies the marker number to query. |
CALCulate:MARKer1:Y?
Enable or disable the marker table. The query returns the status of the marker table.
| Name | Type | Values | Description |
|---|---|---|---|
| state | boolean | OFF | ON | 0 | 1 | Enable 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.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | 0 | 1 | Turns signal tracking off or on. |
Execute self-calibration immediately.
::CALibration:ALL
Enable or disable auto calibration. The query returns the current auto calibration status.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | 0 | 1 | Turns auto calibration off or on. |
:CALibration:AUTO ON or :CALibration:AUTO 1 :CALibration:AUTO?
Queries the current measurement function.
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.
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.
Enable the Pass/Fail test function.
Disables the current measurement function and sets the spectrum analyzer to sweep mode.
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.
Sets all related parameters automatically according to the coupling relationship, or queries the current coupling-linked setting status.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ALL | NONE | Coupling-linked setting state. |
:COUPle NONE :COUPle?
Sets or queries the position of the active function area on the screen.
| Name | Type | Values | Description |
|---|---|---|---|
| position | enum | BOTTom | CENTer | TOP | Position of the active function area. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| stateopt | boolean | OFF | ON | 0 | 1 | Turns 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.
| Name | Type | Values | Description |
|---|---|---|---|
| integer | integer | 0 - 7 | Brightness level to set. |
:DISPlay:BRIGhtness 6 :DISPlay:BRIGhtness?
Sets the on/off state of the screen. The query returns the screen state as 0 or 1.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | 0 | 1 | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | 0 | 1 | Sets the message display state. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | 0 | 1 | Enables 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.
| Name | Type | Values | Description |
|---|---|---|---|
| integer | integer | 0 - 10 | Brightness level of the screen grid. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| spacing | enum | LINear | LOGarithmic | Selects linear or logarithmic X-axis spacing. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| ampl | real | The current amplitude range | Position 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.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | 0 | 1 | Enable 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.
| Name | Type | Values | Description |
|---|---|---|---|
| rel_ampl | real | 0.1 dB - 20 dB | Y-axis scale value. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| ampl | real | -100 - 20 | Reference level value. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| <rel_ampl> | real | -300 dB - 300 dB | Relative amplitude offset to apply to the reference level. |
:DISPlay:WINdow:TRACe:Y:SCALe:RLEVel:OFFSet 10 :DISPlay:WINdow:TRACe:Y:SCALe:RLEVel:OFFSet?
Sets or queries the Y-axis scale spacing type.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | LINear | LOGarithmic | Selects linear or logarithmic Y-axis spacing. |
: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.
: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.
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.
: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.
":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.
: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.
: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.
: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.
::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.
. :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.
: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.
: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.
: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.
: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.
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.
{: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.
: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.
: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.
য
Query the transmit frequency error. It selects data from the latest occupied bandwidth measurement results and transmits the data to the output buffer.
: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.
: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.
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.
FETCh:TPOWer?
Sets the byte order of binary data transmission. The query returns the current byte order as NORM or SWAP.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | NORMal | SWAPped | Byte order used for binary data transmission. |
:FORMat:BORDer NORMal :FORMat:BORDer?
Sets or queries the input/output format of the trace data.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | ASCii | REAL[,32] | Selects the trace data format. |
:FORMat:TRACe:DATA REAL,32 :FORMat:TRACe:DATA?
Cancel the current print operation.
Sets the print color to gray or color, and the query returns the current print color state.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | 0 | 1 | Selects gray or color printing. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | DEFault | EXIFjpeg | Image type of the print. |
:HCOPy:IMAGe:FTYPe EXIFjpeg :HCOPy:IMAGe:FTYPe?
Enable or disable inverted print. Query the status of inverted print.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | 0 | 1 | Enables or disables inverted print. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | 0 | 1 | Enables or disables date print. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| quality | enum | DEFault | NORMal | DRAFt | FINE | Print quality setting. |
Execute the print operation.
Set the print orientation to landscape or portrait. Query the print orientation.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | LANDscape | PORTrait | Print orientation. |
:HCOPy:PAGE:ORIentation PORTrait :HCOPy:PAGE:ORIentation?
Set the print copies. The query returns the current print copies.
| Name | Type | Values | Description |
|---|---|---|---|
| integer | integer | 1 - 999 | Number of print copies to set. |
:HCOPy:PAGE:PRINts 10 :HCOPy:PAGE:PRINts?
Set or query the page size of the print. The page size can be DEFault, A4, A5, A6, or B5.
| Name | Type | Values | Description |
|---|---|---|---|
| page size | enum | DEFault | A4 | A5 | A6 | B5 | Page size of the print. |
:HCOPy:PAGE:SIZE A5 :HCOPy:PAGE:SIZE?
Resumes the paused print task.
Clear all the event registers and clear the error queue.
Set or query the enable register for the standard event status register.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 255 | Enable register value. |
Query and clear the event register for the standard event status register.
*ESR?
Queries the instrument ID string.
*IDN?
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?
Restore the instrument to its default state.
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.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 255 | Value to load into the status byte register enable register. |
*SRE 16 *SRE?
Queries the status byte register. The return is the decimal sum of all enabled bits; bits 0 and 1 are always treated as 0.
*STB?
Trigger a sweep or measurement immediately.
Query whether the self-check operation is finished.
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.
| Name | Type | Values | Description |
|---|---|---|---|
| state | boolean | OFF | ON | 0 | 1 | Selects continuous or single sweep/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.
Switch the measurement state of the instrument from "Wait for Trigger" to "Pause".
Restart the current measurement when the instrument is in idle state.
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.
Sets the input impedance for the voltage-to-power conversion. The query returns the current input impedance.
| Name | Type | Values | Description |
|---|---|---|---|
| impedance | discrete | 50 | 75 | Input impedance for the voltage-to-power conversion. |
:INPut:IMPedance 75 :INPut:IMPedance?
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.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | 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.
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | ANTenna | CABLe | OTHer | USER | Specifies the correction file category. |
| file_name | string | - | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | Path and filename of the setup file to load. |
:MMEMory:LOAD:SETUp D:\Setup0:pf.set
Load the specified state file (.sta).
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | Path and filename of the trace file to load. |
:MMEMory:LOAD:TRACe D:\Trace0:t1.trc
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.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name1 | string | - | Source file name to rename. |
| file_name2 | string | - | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | ANTenna | CABLe | OTHer | USER | Selects 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.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| <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.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| <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.
| Name | Type | Values | Description |
|---|---|---|---|
| file_name | string | - | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| <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.
| Name | Type | Values | Description |
|---|---|---|---|
| label | enum | TRACE1 | TRACE2 | TRACE3 | MATH | ALL | Specifies which trace to save. |
| file_name | string | - | 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.
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.
Execute an adjacent channel power measurement and return the main channel power.
: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.
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.
Execute a channel power measurement and return the channel power.
: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.
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.
: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.
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.
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.
Execute an emission bandwidth measurement and return the measurement result. The query returns the emission bandwidth as an integer in Hz.
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.
: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.
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.
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.
Execute an occupied bandwidth measurement and return the measurement results.
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.
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.
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.
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.
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.
Query the value of the condition register for the operation status register.
Set the value of the enable register for the operation status register.
| Name | Type | Values | Description |
|---|---|---|---|
| integer | integer | 0 - 32767 | Value of the operation status enable register. |
Query the value of the event register for the operation status register.
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.
Sets or queries the value of the enable register for the questionable status register.
| Name | Type | Values | Description |
|---|---|---|---|
| integer | integer | 0 - 32767 | Value written to the questionable status register enable register. |
Queries the value of the event register for the questionable status register.
Enable or disable the beeper in Pass/Fail test. The query returns the beeper status.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | 0 | 1 | Beeper state to set. |
[:SYSTem:]BEEPer:STATe ON [:SYSTem:]BEEPer:STATe 1 [:SYSTem:]BEEPer:STATe?
Clear all the data of user settings.
Selects the current communication port, or disables all communication ports. The query reports the currently selected communication port.
| Name | Type | Values | Description |
|---|---|---|---|
| port | enum | GPIB | LAN | USB | OFF | Current communication port to select, or OFF to disable all communication ports. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | 0 | 1 | Selects 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.
| Name | Type | Values | Description |
|---|---|---|---|
| integer | integer | 0 - 30 | GPIB address to set. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | 0 | 1 | Turns the auto IP setting mode off or on. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | 0 | 1 | Enables or disables DHCP mode. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| ip_address | string | - | 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. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| ip_address | string | - | DNS server address in nnn.nnn.nnn.nnn format; first octet 1 to 223 except 127, remaining octets 0 to 255. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| ip_address | string | - | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| ip_address | string | - | Subnet mask value in nnn.nnn.nnn.nnn format, with each nnn ranging from 0 to 255. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | 0 | 1 | Enables 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?
Reset the LAN setting by enabling DHCP and Auto IP and disabling the Manual IP.
Query the USB device address.
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.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | TMC | PRINter | AUTO | USB 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.
Query the system message displayed lately. Up to 71 history messages can be displayed.
:SYSTem:CONFigure:MESSage?
Sets the instrument date or queries the current date.
| Name | Type | Values | Description |
|---|---|---|---|
| year | string | 2000 - 2099 | Year of the instrument date. |
| month | string | 01 - 12 | Month of the instrument date. |
| day | string | 01 - 31 | Day of the instrument date. |
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".
Enables or disables the front panel power switch. The query returns the current switch status as 0 or 1.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | 0 | 1 | Enable or disable the front panel power switch. |
:SYSTem:FSWItch:STATe OFF or :SYSTem:FSWItch:STATe 0 :SYSTem:FSWItch:STATe?
Lock or unlock the specified function key. The query checks whether the specified key is locked.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | 0 | 1 | Enable or disable key locking. |
| key | enum | FREQ | SPAN | AMP | BW | SWEEP | TRACE | MARK | MARKFUNC | MARKTO | PEAK | TUNE | MEAS | MEASSET | DEMOD | SYSTEM | PRINTSETUP | STORAGE | PRESET | PRINT | ALL | Specifies which front-panel key or keys are affected. |
Set or query the instrument language.
| Name | Type | Values | Description |
|---|---|---|---|
| language | enum | ENGLish | CHINese | JAPan | PORTugese | GERMan | POLish | KORea | TCHinese | Language to set. |
:SYSTem:LANGuage CHINese :SYSTem:LANGuage?
Queries the status of line mode.
:SYSTem:LINemod:STATe? :SYSTem:LINemod:STATe?
Sets the preset setting used in line mode, or exits line mode.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | FACTory | USER1 | USER2 | USER3 | USER4 | USER5 | USER6 | OFF | Preset setting used in line mode, or OFF to exit line mode. |
::SYSTem:LINemod:TYPe USER4
Install and activate the specified option. The query returns the serial number of the specified option.
| Name | Type | Values | Description |
|---|---|---|---|
| license key | string | - | 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.
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.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | PRESet | LAST | Power-on recall setting. |
:SYSTem:PON:TYPE LAST :SYSTem:PON:TYPE?
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.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | USER1 | USER2 | USER3 | USER4 | USER5 | USER6 | Selects which user preset file to save. |
| name | string | - | 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.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | FACTory | USER1 | USER2 | USER3 | USER4 | USER5 | USER6 | Preset 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.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | 0 | 1 | Turns 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.
| Name | Type | Values | Description |
|---|---|---|---|
| integer | integer | 0 - 255 | Volume setting for the earphone in demodulation. |
Sets the instrument time, or queries the current instrument time.
| Name | Type | Values | Description |
|---|---|---|---|
| hour | string | 00 - 23 | Hour of the time to set. |
| minute | string | 00 - 59 | Minute of the time to set. |
| second | string | 00 - 59 | Second of the time to set. |
:SYSTem:TIME 15,10,30 :SYSTem:TIME?
Query the connection status of TX1000.
Sets the on/off status of one TX1000 switch. This command is only available when TX1000 is connected.
| Name | Type | Values | Description |
|---|---|---|---|
| switch | enum | SW1 | SW2 | SW3 | SW4 | SW5 | Selects which TX1000 switch to control. |
| state | enum | OFF | ON | 0 | 1 | Sets 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.
| Name | Type | Values | Description |
|---|---|---|---|
| switch | enum | SW1 | SW2 | SW3 | SW4 | SW5 | Selects one of the five TX1000 switches. |
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.
| Name | Type | Values | Description |
|---|---|---|---|
| <key_value> | enum | FREQ | 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 | PAGEdown | Related function assigned to a UserKey. |
: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.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | 0 | 1 | Sets the UserKey setting state. |
:SYSTem:USERkey:STATe ON or :SYSTem:USERkey:STATe 1 :SYSTem:USERkey:STATe?
Query the SCPI version of the instrument.
Clear the number of trace averages currently executed.
Set the number of averages of the trace. The query returns the number of averages of the trace.
| Name | Type | Values | Description |
|---|---|---|---|
| integer | integer | 1 - 1000 | Number of trace averages to use. |
Query 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".
Clear all the traces by setting the type of all traces to BLANK (Off).
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.
| Name | Type | Values | Description |
|---|---|---|---|
| trace | enum | TRACE1 | TRACE2 | TRACE3 | TRACE4 | Specifies which trace to access. |
| data | block | - | 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
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.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | T1 | T2 | T3 | Trace selection for A in the trace math expression. |
:TRACe:MATH:A T2 :TRACe:MATH:A?
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.
| Name | Type | Values | Description |
|---|---|---|---|
| -- | enum | T1 | T2 | T3 | Selects trace 1, trace 2, or trace 3. |
Sets or queries the constant used in the trace math expression.
| Name | Type | Values | Description |
|---|---|---|---|
| integer | real | -300 dB - 300 dB | Consecutive real number constant for the trace math expression. |
: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.
Query the number of peaks in the peak table.
Set or query the sorting rule of the peak table.
| Name | Type | Values | Description |
|---|---|---|---|
| sorting rule | enum | AMPLitude | FREQuency | Sorting 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.
| Name | Type | Values | Description |
|---|---|---|---|
| state | boolean | OFF | ON | 0 | 1 | Sets the peak table state. |
Sets or queries the display mode of the peak in the peak table.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | NORMal | DLMore | DLLess | Display mode for 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.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | OFF | ON | 0 | 1 | Turns the trace math operation off or on. |
Set or query the operation type of the trace.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | A-B | A+CONST | A-CONST | Operation type of the trace. |
:TRACe:MATH:TYPE A+CONST :TRACe:MATH:TYPE?
Set the average type of trace <n>. Query the average type of trace.
| Name | Type | Values | Description |
|---|---|---|---|
| nopt | discrete | 1 - 3 | Trace number. |
| mode | enum | VIDeo | RMS | Average type for the trace. |
:TRACe<n>:AVERage:TYPE VIDeo|RMS :TRACe<n>:AVERage:TYPE?
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.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 3 | Trace number. |
| mode | enum | WRITe | MAXHold | MINHold | VIEW | BLANk | VIDeoavg | POWeravg | 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.
Sets the trigger edge of the external trigger and queries the current external trigger edge.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | POSitive | NEGative | Trigger 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.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | IMMediate | VIDeo | EXTernal | Trigger source type to set. |
:TRIGger:SEQuence:SOURce EXTernal :TRIGger:SEQuence:SOURce?
Sets the trigger level for video trigger. The query returns the trigger level in scientific notation.
| Name | Type | Values | Description |
|---|---|---|---|
| ampl | real | -300 - 50 | Consecutive real number specifying the video trigger level. |
:TRIGger:SEQuence:VIDeo:LEVel 10 :TRIGger:SEQuence:VIDeo:LEVel?
Sets or queries the unit of the Y axis. The default log unit is dBm and the default linear unit is V.
| Name | Type | Values | Description |
|---|---|---|---|
| unit | enum | DBM | DBMV | DBUV | V | W | Selects the Y-axis unit. |
:UNIT:POWer W :UNIT:POWer?