Resets the trigger system. This has the effect of aborting the sweep or any measurement that is currently in progress. Additionally, any pending operation flags that were set by initiation of the trigger system will be set to false. If :INITiate:CONTinuous is OFF (i.e. the instrument is in single sweep mode), send the command :INITiate[:IMMediate] to trigger the next sweep. If :INITiate:CONTinuous is ON (i.e. the instrument is in continuous sweep mode) a new sweep will start immediately.
:CALCulate<n>:LIMit<n>:COMMent <string>
:CALCulate<n>:LIMit<n>:COMMent?
Title:
Limit Comment
Description:
Associates a user-defined comment with each limit. The set version of this command takes a single parameter that is a string containing the desired comment. The query version returns the comment that is set.
If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).
Move a limit line along the control axis. This command changes the value of :CALCulate<n>:LIMit<k>:CONTrol[:DATA].
Issuing this command multiple times will change the limits each time. For example, sending
CALC:LIM1:CONT:SHIFT 1 Hz
CALC:LIM1:CONT:SHIFT 1 Hz
CALC:LIM1:CONT:SHIFT 1 Hz
CALC:LIM1:CONT:SHIFT 1 Hz
CALC:LIM1:CONT:SHIFT 1 Hz
will shift the control axis by 5 Hz
If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).
Parameter(s):
<numeric_value> {HZ | KHZ | MHZ | GHZ}
CALCulate Suffix Range:
1, Default = 1
LIMit Suffix Range:
1-10, Default = 1
:CALCulate<n>:LIMit<n>:COPY <numeric_value>
Title:
Limit Copy
Description:
Copies a limit line eg: CALC:LIM1:COPY 2 Copies limit 1 to line 2
If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).
Parameter(s):
<numeric_value>
CALCulate Suffix Range:
1, Default = 1
LIMit Suffix Range:
1-10, Default = 1
:CALCulate<n>:LIMit<n>:DELete
Title:
Limit Delete
Description:
Deletes a limit line
If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).
CALCulate Suffix Range:
1, Default = 1
LIMit Suffix Range:
1-10, Default = 1
:CALCulate<n>:LIMit<n>:FAIL?
Title:
Limit Fail
Description:
This command queries the result of a limit check. All traces that have had checking enabled (via CALC:TRAC:CHEC) will be evaluated against the upper and lower data of the specified limit, unless the limit STATe is OFF (in which case this command will always return 0), or the upper or lower STATe is OFF (in which case only the data with STATe ON will be checked).
If the sweep has not completed yet, the partial trace will be evaluated. If INITiate:CONTinuous is ON, a snapshot of the trace at the time this command was received will be evaluated against the limit. This command returns 1 if any of the checked traces violate the limit, otherwise it returns 0.
When a limit is evaluated, there are some rules that are followed if the cardinality of the limits control, upper, and lower data are not equal. If there are fewer control data points than upper or lower data points, then only the first n upper or lower points will be evaluated, where n is the number of control points. If there are fewer upper or lower points than control points, then the effective number of upper or lower points will be increased to the number of control points, with the 'extrapolated' points having a value equal to the last upper or lower point.
If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).
Move the lower limit up or down by a relative amplitude. This command changes the value of :CALCulate<n>:LIMit<k>:LOWer[:DATA].
Issuing this command multiple times will change the limits each time. For example, sending
CALC:LIM1:LOW:SHIFT 1 dB
CALC:LIM1:LOW:SHIFT 1 dB
CALC:LIM1:LOW:SHIFT 1 dB
CALC:LIM1:LOW:SHIFT 1 dB
CALC:LIM1:LOW:SHIFT 1 dB
will shift the lower limit by 5 dB
If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).
See UNIT:POWer to query or set the current amplitude units.
Parameter(s):
<numeric_value> {DB}
CALCulate Suffix Range:
1, Default = 1
LIMit Suffix Range:
1-10, Default = 1
:CALCulate<n>:LIMit<n>:LOWer:STATe <0 | 1 | ON | OFF>
:CALCulate<n>:LIMit<n>:LOWer:STATe?
Title:
Lower Limit State
Description:
Turns ON or OFF the lower limit.
If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).
Parameter(s):
<0 | 1 | ON | OFF>
CALCulate Suffix Range:
1, Default = 1
LIMit Suffix Range:
1-10, Default = 1
:CALCulate<n>:LIMit<n>:NAME <string>
:CALCulate<n>:LIMit<n>:NAME?
Title:
Limit Name
Description:
Associates a user-defined name with each limit. The set version of this command takes a single parameter that is a string containing the desired limit name. The query version returns the name that is set.
If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).
Parameter(s):
<string>
CALCulate Suffix Range:
1, Default = 1
LIMit Suffix Range:
1-10, Default = 1
:CALCulate<n>:LIMit<n>:STATe <0 | 1 | ON | OFF>
:CALCulate<n>:LIMit<n>:STATe?
Title:
Limit State
Description:
Turns the limit check for a specific limit ON or OFF.
If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).
Parameter(s):
<0 | 1 | ON | OFF>
CALCulate Suffix Range:
1, Default = 1
LIMit Suffix Range:
1-10, Default = 1
:CALCulate<n>:LIMit<n>:TRACe<n>:CHECk <0 | 1 | ON | OFF>
:CALCulate<n>:LIMit<n>:TRACe<n>:CHECk?
Title:
Limit Trace Check
Description:
This command turns the limit check for a specific trace on and off.
If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).
This command sets or queries the control data (X-axis values) for the specified limit.
The numeric suffix on LIMit specifies which limit number to query or set data. If the suffix is omitted, the command will refer to limit 1.
If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).
This command takes a list of one or more frequency values as parameters. For example,
CALC:LIM1:CONT:DATA 1 MHz, 2MHz, 3MHz
Note that it is permitted to set one or more invalid 'placeholder' values of Not-A-Number (NAN). The placeholder value for NAN is 9.91e37. If a control data point contains a value of 9.91e37, limit line interpolation from the previous data point, and to the next data point, will not occur. This is useful for defining discontiguous (or segmented) limit lines within a single limit.
For example, to define a limit line of two discontiguous segments, one from 1 MHz to 10 MHz, and another from 20 MHz to 30 MHz, send the following control data:
Note that the upper (or lower) data, if used, should contain the same amount of points as the control data (see CALC:LIM:FAIL? for details on what happens when this is not true). Thus, when using placeholders in control data, it is recommended that placeholders are also used in the upper (or lower) data. For example,
The exact value for the middle point does not matter, as interpolation will always be skipped due to the control data containing NAN, but using NAN for the corresponding upper (or lower) data value will make it easier to remember that the point is a placeholder.
This command sets or queries the lower limit data (Y-axis values) for the specified limit.
The numeric suffix on LIMit specifies which limit number to query or set data. If the suffix is omitted, the command will refer to limit 1.
If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).
This command takes a list of one or more amplitude values as parameters. For example,
CALC:LIM1:LOW:DATA 1 dBm, 2dBm, 3 dBm
Note that it is permitted to set one or more data values of +/- infinity. The placeholder value for +/- infinity is +/-9.9e37. If a lower data point contains a value of +/-9.9e37, the amplitude at that point will be treated as if it were +/-inifinity (i.e. the lower limit will either always fail or always pass at that point).
It is also permitted to set one or more invalid 'placeholder' values of Not-A-Number (NAN). This is useful for defining discontiguous (or segmented) limit lines within a single limit. For details, and an example, of using placeholder values, see CALC:LIM:CONT:DATA.
See UNIT:POWer to query or set the current amplitude units.
This command is used to create an Lower limit envelope on the selected trace.
LIMit Suffix Range:
1-10, Default = 1
:CALCulate:LIMit<n>:LOWer[:TRACe]:POINts?
Title:
Lower Limit Points
Description:
This command queries the upper limit trace points (Y-axis values) for the specified limit. This differs from the limit data in that a value is returned for each point in the trace to indicate the values that are being used to evaluate limit pass/fail status.
The numeric suffix on LIMit specifies which limit number to query or set data. If the suffix is omitted, the command will refer to limit 1.
If a limit of the specified number does not exist, an empty list will be returned.
This command sets or queries the upper limit data (Y-axis values) for the specified limit.
The numeric suffix on LIMit specifies which limit number to query or set data. If the suffix is omitted, the command will refer to limit 1.
If a limit of the specified number does not already exist, a default limit will be created first (having empty data, with state set to ON).
This command takes a list of one or more amplitude values as parameters. For example,
CALC:LIM1:UPP:DATA 1 dBm, 2dBm, 3 dBm
Note that it is permitted to set one or more data values of +/- infinity. The placeholder value for +/- infinity is +/-9.9e37. If an upper data point contains a value of +/-9.9e37, the amplitude at that point will be treated as if it were +/-inifinity (i.e. the upper limit will either always pass or always fail at that point).
It is also permitted to set one or more invalid 'placeholder' values of Not-A-Number (NAN). This is useful for defining discontiguous (or segmented) limit lines within a single limit. For details, and an example, of using placeholder values, see CALC:LIM:CONT:DATA.
See UNIT:POWer to query or set the current amplitude units.
This command is used to create an Upper limit envelope on the selected trace.
LIMit Suffix Range:
1-10, Default = 1
:CALCulate:LIMit<n>:UPPer[:TRACe]:POINts?
Title:
Upper Limit Points
Description:
This command queries the upper limit trace points (Y-axis values) for the specified limit. This differs from the limit data in that a value is returned for each point in the trace to indicate the values that are being used to evaluate limit pass/fail status.
The numeric suffix on LIMit specifies which limit number to query or set data. If the suffix is omitted, the command will refer to limit 1.
If a limit of the specified number does not exist, an empty list will be returned.
LIMit Suffix Range:
1-10, Default = 1
:CALCulate:LIMit:ALARm <0 | 1 | ON | OFF>
:CALCulate:LIMit:ALARm?
Title:
Limit Alarm
Description:
This command enables/disables the AAE notification for limit failures.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
:CALCulate:LIMit:ENVelope:OFFSet <numeric_value> {<amplitude_units>} | DEFault | MINimum | MAXimum
This command sets/gets the limit envelope offset. This defines how far away from the measured signal indicated the limit envelope is placed. Use :CALCulate:LIMit:TYPe to set the currently active limit line.
See UNIT:POWer to query or set the current amplitude units.
Query Return:
Numeric (<amplitude_units>)
Set Command Parameter(s):
<numeric_value> {<amplitude_units>} | DEFault | MINimum | MAXimum
Query Command Parameter(s):
[DEFault | MINimum | MAXimum]
Default Value:
3 dBm
Default Unit:
dBm
Range:
-100 dBm to 100 dBm
:CALCulate:LIMit:ENVelope:POINt <numeric_value> | DEFault | MINimum | MAXimum
This command sets the number of inflection point for the limit envelope.
Query Return:
Numeric
Set Command Parameter(s):
<numeric_value> | DEFault | MINimum | MAXimum
Query Command Parameter(s):
[DEFault | MINimum | MAXimum]
Default Value:
20
Range:
2 to 41
:CALCulate:LIMit:ENVelope:SHAPe <SQUare|SLOPe>
:CALCulate:LIMit:ENVelope:SHAPe?
Title:
Limit Envelope Shape
Description:
This command sets/gets the currently active limit envelope shape.
Parameter(s):
<SQUare|SLOPe>
Query Return:
SQU|SLOP
Default Value:
SQUare
:CALCulate:MARKer<n>:FUNCtion <OFF|NOISe>
:CALCulate:MARKer<n>:FUNCtion?
Title:
Marker Function
Description:
Select the marker function to perform post-processing operation. The default/OFF function performs pass through operation.
Parameter(s):
<OFF|NOISe>
Query Return:
OFF|NOIS
MARKer Suffix Range:
1-12, Default = 1
Default Value:
OFF
:CALCulate:MARKer<n>:MAXimum
Title:
Maker Move To Highest Peak
Description:
Moves the marker X value to the point in the marker's assigned trace that has the highest peak.
MARKer Suffix Range:
1-12, Default = 1
:CALCulate:MARKer<n>:MAXimum:LEFT
Title:
Marker Move To Left Peak
Description:
Moves the marker X value to the point in the marker's assigned trace that is the next highest peak to the LEFT of the current X position of the marker.
MARKer Suffix Range:
1-12, Default = 1
:CALCulate:MARKer<n>:MAXimum:NEXT
Title:
Marker Move To Next Peak
Description:
Moves the marker X value to the point in the marker's assigned trace that is the next highest peak.
MARKer Suffix Range:
1-12, Default = 1
:CALCulate:MARKer<n>:MAXimum:RIGHt
Title:
Marker Move To Right Peak
Description:
Moves the marker X value to the point in the marker's assigned trace that is the next highest peak to the RIGHT of the current X position of the marker.
Select the marker mode. POSition mode is a normal marker mode. DELTa mode is marker report difference relative to another marker. FIXed mode is a marker who's Y value is fixed at the last measured value before it is set to FIXed. OFF mode is disable the marker.
Parameter(s):
<POSition|DELTa|FIXed|OFF>
Query Return:
POS|DELT|FIX|OFF
MARKer Suffix Range:
1-12, Default = 1
Default Value:
OFF
:CALCulate:MARKer<n>:MOVE:LEFT
Title:
Marker Move To Left
Description:
Moves the marker X value to the next display point to the LEFT.
MARKer Suffix Range:
1-12, Default = 1
:CALCulate:MARKer<n>:MOVE:RIGHt
Title:
Marker Move To Right
Description:
Moves the marker X value to the next display point to the RIGHT.
MARKer Suffix Range:
1-12, Default = 1
:CALCulate:MARKer<n>:REFerence <numeric_value>
:CALCulate:MARKer<n>:REFerence?
Title:
Marker Reference
Description:
Sets the reference marker for the specified delta marker. This setting will be applied only if the marker mode set to DELTa.
Parameter(s):
<numeric_value>
Query Return:
Numeric
MARKer Suffix Range:
1-12, Default = 1
Default Value:
0
Range:
0 to 12
:CALCulate:MARKer<n>[:SET]:CENTer
Title:
Marker Set Center
Description:
Sets the center frequency of the instrument to the current X value of the marker.
MARKer Suffix Range:
1-12, Default = 1
:CALCulate:MARKer<n>[:SET]:RLEVel
Title:
Marker Set Reference Level
Description:
Sets the reference level of the instrument to the current Y value of the marker.
MARKer Suffix Range:
1-12, Default = 1
:CALCulate:MARKer<n>:TRACe <numeric_value>
:CALCulate:MARKer<n>:TRACe?
Title:
Marker Trace
Description:
Changes the trace to which the marker is currently attached.
Sets the excursion for a marker. The excursion is the vertical distance from the peak to the next highest valley which must be exceeded for a peak to be considered a peak in marker max commands.
See UNIT:POWer to query or set the current amplitude units.
Query Return:
Numeric (dB)
Set Command Parameter(s):
<numeric_value> {DB} | DEFault | MINimum | MAXimum
Query Command Parameter(s):
[DEFault | MINimum | MAXimum]
Default Value:
0 dB
Default Unit:
dB
Range:
0 dB to 200 dB
:CALCulate:MARKer:PEAK:EXCursion:STATe <0 | 1 | ON | OFF>
:CALCulate:MARKer:PEAK:EXCursion:STATe?
Title:
Marker Excursion State
Description:
Turn on/off excursion checking for marker max commands.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
:CALCulate:MARKer:PEAK:THReshold <numeric_value> {<amplitude_units>} | DEFault | MINimum | MAXimum
Sets the threshold level which peak powers must exceed to be reported by FETC:PEAK? query.
See UNIT:POWer to query or set the current amplitude units.
Parameter(s):
<numeric_value> {<amplitude_units>}
Query Return:
Numeric (<amplitude_units>)
Default Value:
0 dBm
Default Unit:
dBm
Range:
-150 dBm to 30 dBm
:CALCulate:PEAK:THReshold:STATe <0 | 1 | ON | OFF>
:CALCulate:PEAK:THReshold:STATe?
Title:
Peak Threshold State
Description:
Turn ON|OFF the threshold that peak powers must exceed to be reported by PEAKS? query.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
:CONFigure:ACPower
Title:
Configure Adjacent Channel Power Ratio
Description:
Configures the default adjacent channel power ratio measurement. Disables any other active one-button measurements, including channel power, occupied bandwidth, AM/FM demodulation and C/I. Sets the main channel bandwidth equal to the span. Sets the adjacent channel bandwidth and channel spacing equal to the main channel bandwidth. Sets the detection method to RMS. Sets the instrument to single sweep mode (:INITiate:CONTinuous OFF). Measurement settings can be modified by using the [:SENSe]:ACPower commands before initiating a sweep.
:CONFigure:CHPower
Title:
Configure Channel Power
Description:
Configures the default channel power measurement.Disables any other active one-button measurements, including ACPR, occupied bandwidth, AM/FM demodulation and C/I. Sets the integration bandwidth equal to the span. Sets the detection method to RMS. Sets the instrument to single sweep mode (:INITiate:CONTinuous OFF). Measurement settings can be modified by using the [:SENSe]:CHPower commands before initiating a sweep. Note that this measurement is not valid in zero span.
:CONFigure:OBWidth
Title:
Configure Occupied Bandwidth
Description:
Configures the default occupied bandwidth measurement. Disables any other active one-button measurements, including channel power, ACPR, AM/FM demodulation and C/I. Sets the method to %. Sets the % of power to 99%. Sets the instrument to single sweep mode (:INITiate:CONTinuous: OFF). Measurement settings can be modified by using the [:SENSe]:OBWidth commands before initiating a sweep. Note that this measurement is not valid in zero span.
Get information for SFP ports connected to the board.
The numeric suffix on PORT specifies which sfp port number to query. If the suffix is omitted, the command will refer to sfp port 1
The command takes below query parameters: WLEN|BRAT|VNAM|STAT|PNUM|REV|SNUM|PDAT|LCOD|TCOMP|SMLEN|MM50LEN|MM62P5LEN|CLEN|TXPWR|RXPWR|ALL
WLEN return wavelength
BRAT return the bit rate
VNAM return the vendor name
STAT return the status
PNUM return the product number
REV return the revision
SNUM return the serial number
PDAT return the product date
LCOD return the lot code
TCOMP return transceiver compliance
SMLEN return 9 um length
MM50LEN return 50 um length
MM62P5LEN return 62.5 um length
CLEN return copper lenth
TXPWR return transmit power
RXPWR return receive power
ALL return all the above parameters as key=value comma separated values
if any of the above parameter has invalid value, N/A is returned for its value Note: if a sfp is compliant with multiple transceivers then the value is separated by "|"
eg:TCOMP=10G Base-LR|OC48/STM 16 IR where the sfp is compliant with 10G Base-LR and OC48/STM 16 IR
Returns the CPRI Layer 2 Alarms status for the specified SFP port as a decimal integer representing the bitwise-OR of one or more status bits:
Bit Meaning
0 SLOS (Optical signal loss)
1 LOS (Loss of Signal)
2 LOF (Loss of Frame)
3 LSS (Loss of Signal Synchronization)
4 RLOS (Remote Loss of Signal)
5 RLOF (Remote Loss of Fiber)
6 RAI (Remote Alarm Indication)
7 SDI (SAP Defect Indication)
8 Reset Request
9-30 Not Implemented
31 Active (SFP connected)
Alarm statuses are only meaningful when an SFP is connected. When an SFP is connected, the Active bit will be set. If this bit is 0 (inactive), the values of the other bits are undefined. When reading the alarm status, we recommend checking the Active bit first to determine if it makes sense to read the other bits.
PORT Suffix Range:
1-2, Default = 1
:DIAGnostic:CPRI:VERSion:CPLD?
Title:
CPRI CPLD Version
Description:
Retrieve the CPLD version. The response is returned as a string of the form X.YZ, for example, 1.00.
:DIAGnostic:CPRI:VERSion:FPGA?
Title:
CPRI FPGA Version
Description:
Retrieve the CPRI FPGA version number.
The CPRI FPGA implements the measurement capability to convert CPRI I/Q data into a spectrum.
The response is returned as a string of the form X.YZ, for example, 1.00.
:DIAGnostic:CPRI:VERSion:FPGA:CORe?
Title:
Core (CPRI) FPGA Version
Description:
Retrieve the Core (CPRI) FPGA version number.
The Core FPGA implements logic to decode the CPRI protocol.
The response is returned as a string of
the form X.YZ, for example, 1.00.
:DIAGnostic:REFerence:DAC <numeric_value> | DEFault | MINimum | MAXimum
Set the value of the reference DAC for MS2760A and MA24507A models.
Query Return:
Numeric
Set Command Parameter(s):
<numeric_value> | DEFault | MINimum | MAXimum
Query Command Parameter(s):
[DEFault | MINimum | MAXimum]
Default Value:
39321
Range:
0 to 65535
:DIAGnostic:SWEep:TIME?
Title:
Measured Sweep Time
Description:
This command queries the measured sweep time, in number of milliseconds. This command will return "nan" if no measured sweep time is available, which happens if the sweep was reset and the instrument has not yet swept enough to measure a full sweep.
:DISPlay:POINtcount <numeric_value> | DEFault | MINimum | MAXimum
Changes the number of display points the instrument currently measures. Increasing the number of display points can improve the resolution of measurements but will also increase sweep time.
Query Return:
Numeric
Set Command Parameter(s):
<numeric_value> | DEFault | MINimum | MAXimum
Query Command Parameter(s):
[DEFault | MINimum | MAXimum]
Default Value:
501
Range:
10 to 4001
:DISPlay:VIEW <NORMal|SPECtrogram>
:DISPlay:VIEW?
Title:
Display View
Description:
The display view command can be used to enable/disable spectrogram features.
Parameter(s):
<NORMal|SPECtrogram>
Query Return:
NORM|SPEC
Default Value:
NORMal
:DISPlay[:WINDow]:SWEep[:CURRent]:POINt?
Title:
Current Display Point
Description:
This command returns the newest display point index of current sweep. This index can be used to calculate the current sweep progress.
:DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision <numeric_value> | DEFault | MINimum | MAXimum
Set or query the scale per division setting of trace graph. This command doesn't change any behavior in the backend but will be included in save/recall operations.
Sets the reference level amplitude value for the y-axis. This value is the display reference level, which means it has the reference level offset applied. It also means that a change to the reference level offset will change this setting (though the actual, unadjusted reference level will stay the same).
Note that this may cause a change in attenuation if the automatic input attenuation coupling is enabled. For the purpose of coupling, the actual reference level (without the offset applied) is used, though this command will always reflect the display value.
For example, suppose a starting reference level offset of 0 dB and a reference level of 10 dBm. If the offset is set to 20 dB, the display reference level will be set to 10 dBm - 20 dB = -10 dBm; no attenuation change will occur. Likewise, if the starting reference level offset is 20 dB and the (display) reference level is set to 0 dBm, the display reference level will remain at 0 dBm, though the (actual) reference level value used in auto attenuation coupling is 0 dBm + 20 dB = 20 dBm.
To obtain the actual reference level, either add in the reference level offset, or temporarily set the offset to 0 (in which case the display reference level will reflect the actual one).
See UNIT:POWer to query or set the current amplitude units.
This command causes the reference level to immediately be set to an automatically computed value that best displays the particular data. The reference level is set to a specified dB above the selected trace max value. This command is semantically equivalent to :DISPlay[:WINDow]:TRACe[:SCALe]:RLEVel <amplitude> with the computed value for amplitude.
See UNIT:POWer to query or set the current amplitude units.
Parameter(s):
<numeric_value> {DB}
:DISPlay[:WINDow]:TRACe:Y[:SCALe]:RLEVel:OFFSet <numeric_value> {DB} | DEFault | MINimum | MAXimum
Sets the reference level offset value for the y-axis. This offset is used for display purposes only, and does not affect the actual reference level used for auto attenuation coupling, or any other settings that depend on reference level.
See DISP:WIND:TRAC:Y:SCAL:RLEV for details on the interaction between reference level offset and display reference level.
See UNIT:POWer to query or set the current amplitude units.
Query Return:
Numeric (dB)
Set Command Parameter(s):
<numeric_value> {DB} | DEFault | MINimum | MAXimum
Query Command Parameter(s):
[DEFault | MINimum | MAXimum]
Default Value:
0 dB
Default Unit:
dB
Range:
-99.9 dB to 99.9 dB
:FETCh:ACPower?
Title:
Fetch Adjacent Channel Power Ratio
Description:
Returns the most recent adjacent channel power ratio measurement results. If the instrument is sweeping, it will not return until the sweep is complete. If the instrument is not sweeping and the current data is not valid it will return error -230. This could occur if there was a *RST immediately before the :FETCh? or if a measurement parameter was changed without an :INITiate
Data is returned as 9 comma-separated values: main channel power, absolute lower adjacent channel power, absolute upper adjacent channel power, absolute lower alternate channel power,absolute upper alternate channel power, relative lower adjacent channel power, relative upper adjacent channel power, relative lower alternate channel power,relative upper alternate channel power.
If the measurement is not enabled with [:SENSe]:ACPower:STATe then, the instrument will indicate error -400 and return the string "nan,nan,nan,nan,nan,nan,nan,nan,nan"
Returns the amplitude at the given frequency. The command does not wait for the sweep to complete. If the trace data at the requested frequency is invalid (or out of span) then NAN is returned and error code -230 is indicated.
Parameter(s):
<numeric_value> {HZ | KHZ | MHZ | GHZ}
:FETCh:CHPower?
Title:
Fetch Channel Power and Density
Description:
This command returns the most recent channel power measurement results: channel power and channel power density. If the instrument is sweeping, it will not return until the sweep is complete. If the instrument is not sweeping and the current data is not valid it will return error -230. This could occur if there was a *RST immediately before the :FETCh? or if a measurement parameter was changed without an :INITiate.Data is returned as 2 comma-separated values: channel power, channel power density.If the measurement is not enabled with [:SENSe]:CHPower:STATe then, the instrument will indicate error -400 and return the string "nan,nan"
:FETCh:CHPower:CHPower?
Title:
Fetch Channel Power and Density
Description:
Returns the most recent channel power measurement result. It returns only the channel power, not the channel power density. Use :FETCh:CHPower? to get both channel power and channel power density.If the instrument is sweeping, it will not return until the sweep is complete. If the instrument is not sweeping and the current data is not valid it will return error -230.This could occur if there was a *RST immediately before the :FETCh? or if a measurement parameter was changed without an :INITiate.If the measurement is not enabled with [:SENSe]:CHPower:STATe then, the instrument will indicate error -400 and return the string "nan,nan"
:FETCh:CHPower:DENSity?
Title:
Fetch Channel Power Density
Description:
Returns the most recent channel power density measurement result. It returns only the channel power density, not the channel power. Use :FETCh:CHPower? to get both channel power and channel power density. If the instrument is sweeping, it will not return until the sweep is complete. If the instrument is not sweeping and the current data is not valid it will return error -230.This could occur if there was a *RST immediately before the :FETCh? or if a measurement parameter was changed without an :INITiate.If the measurement is not enabled with [:SENSe]:CHPower:STATe then, the instrument will indicate error -400 and return the string "nan,nan"
:FETCh:OBWidth<n>?
Title:
Fetch Occupied Bandwidth
Description:
Returns a different set of measurement information depending on the suffix. The default suffix of 1 will return the most recent occupied bandwidth measurement results: occupied bandwidth, percent of power and dB down. One of either percent of power or dB down is measured and the other is set. That is determined by the value set using [:SENSe]:OBWidth:METHod. If the measurement is not enabled with :SENSe:OBWidth:STATe then, the instrument will indicate error -400 and return the string "nan,nan,nan".
Using suffix 2 will return the most recent channel power, x dB bandwidth, percent bandwidth, and transmit frequency error. The channel power and occupied bandwidth measurements will be calculated regardless of CHP:STAT and OBW:STAT settings. For both suffixes, if the instrument is sweeping, it will not return until the sweep is complete. If the instrument is not sweeping and the current data is not valid it will return error -230. This could occur if there was a *RST immediately before the :FETCh? or if a measurement parameter was changed without an :INITiate.
OBWidth Suffix Range:
1-2, Default = 1
:FETCh:PEAK?
Title:
Fetch Peak
Description:
Returns a pair (amplitude, frequency in Hz) of the peak amplitude in the current sweep. The command does not wait for the sweep to complete. If the trace data is invalid then both numbers in the pair will be NAN and error code -230 will be indicated.
This command specifies the format in which data is returned in TRAC:DATA queries. The optional numeric parameter is needed for REAL format only. It defines the length of the floating point number in bits. Valid values are 32 and 64. If the optional numeric parameter is omitted, the default length of REAL data is set to 64 bits.
ASCii format returns the data in comma-separated ASCII format. The units are the current measurement units.
INTeger,32 values are signed 32-bit integers in little-endian byte order. This format returns the data in 4-byte blocks. The values are scaled by 1000, so if the current measurement units are dBm the integer values would be mdBm. For example, if the measured result was -12.345 dBm, that value would be sent as -12345.
REAL,32 values are 32-bit floating point numbers conforming to the IEEE 754 standard in little-endian byte order. This format returns the data in 4-byte binary format. The units are the current measurement units.
REAL,64 values are 64-bit floating point numbers conforming to the IEEE 754 standard in little-endian byte order. This format returns the data in 8-byte binary format. The units are the current measurement units.
Parameter(s):
<ASCii|INTeger|REAL>,[<numeric_value>]
Query Return:
ASC|INT|REAL
Default Value:
ASCii
:INITiate:CONTinuous <0 | 1 | ON | OFF>
:INITiate:CONTinuous?
Title:
Sweep Type
Description:
Specifies whether the sweep/measurement is triggered continuously. If the value is set to ON or 1, another sweep/measurement is triggered as soon as the current one completes. If continuous is set to OFF or 0, the instrument remains initiated until the current sweep/measurement completes, then enters the 'idle' state and waits for the :INITiate[:IMMediate] command or for :INITiate:CONTinuous ON.
If :INITiate:CONTinuous is changed to ON before the current sweep/measurement completes, a new sweep/measurement will be continously triggered as soon as the current sweep/measurement completes. If :INITiate[:IMMediate] is received before the current sweep/measurement completes, it will be ignored. Clients must either wait for the current sweep/measurement to complete before triggering a 'single sweep', or :ABORt the sweep/measurement after setting :INITiate:CONTinuous to OFF (which will cause the instrument to immediately enter the idle state where it can accept new triggers).
The default value is ON. That is, sending :INIT:CONT is equivalent to sending :INIT:CONT ON. The query version of the command returns a 1 if the instrument is continuously sweeping/measuring and returns a 0 if the instrument is in single sweep/measurement mode.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
ON
:INITiate[:IMMediate]
Title:
Initiate Single Sweep
Description:
Initiates a sweep/measurement. If :INITiate:CONTinuous is set to ON, or if :INITiate:CONTinuous is set to OFF but the current sweep has not completed yet, this command is ignored. Use this command in combination with :STATus:OPERation? or *OPC? to synchronize the capture of one complete set of data. When this command is sent, the "sweep complete" bit of :STATus:OPERation? is set to 0, indicating that the measurement has not completed. The data collection is then triggered. The controlling program can poll :STATus:OPERation? to determine the status. When the "sweep complete" bit is set to 1, data is ready to be retrieved.
This command is also overlapped, so alternatively, *OPC? can be used to wait for completion of the measurement without polling. When this command is received, the pending operation bit is set. The pending operation will finish once the sweep/measurement is done. Clients can use *OPC? to 'block' until the sweep/measurement is completed.
:INITiate[:IMMediate]:ALL
Title:
Initiate Average Count Sweep
Description:
Initiates sweep untill all active traces reach its average count
:INITiate:SPA:SELFtest?
Title:
Self Test
Description:
Perform a self-test and return the results. The response is formatted as a JSON (http://json.org/) array of name,value pair result objects. Some result objects also include a 'status' property that will be either 'pass' or 'fail' based on whether the criteria for that test was met.
For tests of voltages, the test passes if the measured voltage is within 10% of the expected voltage.
:INPut:OPOWer:RELay[:STATe] <CLOSed|OPEN>
:INPut:OPOWer:RELay[:STATe]?
Title:
Set Relay State
Description:
Query the state of the overpower relay, or close it. During an overpower condition, the relay will open automatically to prevent damage to RF circuitry, and the device dependent error bit in the ESR will be set to indicate that an overpower condition occurred. Additionally the instrument will automatically try to close the relay every hour after it detects that the relay is opened
To recover, remove the offending input source and then issue this command with a parameter of CLOSed to close the relay or wait for an hour from the time when the relay was opened for the instrument to close the relay automatically.
Note that while this command returns the relay state as "CLOSed|OPEN", this command only accepts "CLOSed as a parameter" (that is, the relay cannot be manually opened, only closed).
Recovering from an overpower condition requires user interaction, either manually or via an automated program that can send this SCPI command to the instrument or the instrument can itself try closing the relay every hour after it detects an open state. Additionally, if the relay is CLOSed without removing the source of the overpower, it will immediately revert to OPEN.
Parameter(s):
<CLOSed|OPEN>
Query Return:
CLOS|OPEN
Default Value:
CLOSed
:INSTrument:ACTive:STATe <0 | 1 | ON | OFF>
:INSTrument:ACTive:STATe?
Title:
RemoteSpectrumAnalyzerInUse
Description:
Set state of this setting indicates that rsm is used by someone. Unset state indicates it is not used by anyone
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
:INSTrument:REMote:STATe <0 | 1 | ON | OFF>,<string>
:INSTrument:REMote:STATe?
Title:
RemoteSpectrumAnalyzerId
Description:
This command can be used to indicate the device being used by someone. The set command takes two parameters:
- a boolean to indicate whether the device is being used
- a string to indicate the identification of someone currently using the device.
When a value of 1 is passed into the boolean parameter (indicating the device being used), the identification string parameter must be non-empty; otherwise, a scpi error will be generated.
When no longer being used, these settings should be cleared with a boolean parameter of zero. The string paramter does not matter because it will automatically be set to the empty string.
The query command returns the current values of the boolean and the string settings. The remote identification string setting is empty only if it has never been set or has been cleared via this command.
Both settings will be reset after a reboot.
Parameter(s):
<0 | 1 | ON | OFF>,<string>
:MEASure:ACPower?
Title:
Measure Adjacent Channel Power Ratio
Description:
Sets the active measurement to adjacent channel power ratio, sets the default measurement parameters, triggers a new measurement and returns the main channel power, lower adjacent, upper adjacent, lower alternate and upper alternate channel power results. It is a combination of the commands :CONFigure:ACPower; :READ:ACPower? For a description of the default adjacent channel power ratio measurement parameters see :CONFigure:ACPower. To make an adjacent channel power ratio measurement with settings other than the default values send: :CONFigure:ACPower
Commands to set desired settings :READ:ACPower?
Data is returned as 9 comma-separated values: main channel power, absolute lower adjacent channel power, absolute upper adjacent channel power, absolute lower alternate channel power,absolute upper alternate channel power, relative lower adjacent channel power, relative upper adjacent channel power, relative lower alternate channel power,relative upper alternate channel power.
:MEASure:CHPower?
Title:
Measure Channel Power And Density
Description:
Sets the active measurement to channel power, sets the default measurement parameters, triggers a new measurement and returns the channel power and channel power density results. It is a combination of the commands :CONFigure:CHPower; :READ:CHPower? For a description of the default channel power measurement parameters see :CONFigure:CHPower. To make a channel power measurement with settings other than the default values send: :CONFigure:CHPower
Commands to set desired settings: :READ:CHPower?
Data is returned as 2 comma-separated values: channel power, channel power density.
:MEASure:CHPower:CHPower?
Title:
Measure Channel Power
Description:
Sets the active measurement to channel power, sets the default measurement parameters, triggers a new measurement and returns channel power as the result.To measure both channel power and channel power density use MEASure:CHPower? It is a combination of the commands :CONFigure:CHPower; :READ:CHPower? For a description of the default channel power measurement parameters see :CONFigure:CHPower. To make a channel power measurement with settings other than the default values send: :CONFigure:CHPower
Commands to set desired settings: :READ:CHPower?
:MEASure:CHPower:DENSity?
Title:
Measure Channel Power Density
Description:
Sets the active measurement to channel power, sets the default measurement parameters, triggers a new measurement and returns channel power density as the result.To measure both channel power and channel power density use MEASure:CHPower? It is a combination of the commands :CONFigure:CHPower; :READ:CHPower? For a description of the default channel power measurement parameters see :CONFigure:CHPower. To make a channel power measurement with settings other than the default values send: :CONFigure:CHPower
Commands to set desired settings: :READ:CHPower?
:MEASure:IQ:CAPTure
Title:
StartIQCapature
Description:
This set command is used to start the IQ capture measurement. If IQ:MODE is SINGle, this command will triger a single I/Q block capture. While the capture is in progress the I/Q Capture bit of STATus:OPERation? will be set to 1. Clients can read the captured data with the TRAC:IQ:DATA? query.
If IQ:MODE is STREAM, this command will start streaming capture of I/Q data. The most recently captured block of I/Q data can be read with the TRAC:IQ:DATA? query. In STREAM capture mode, the capture will not complete until aborted. While streaming is going, clients will need to continuously read captured blocks with TRAC:IQ:DATA?.
Regardless of the capture mode, the capture can be aborted. The capture can be aborted with the ABORt command preferably, though most commands which change hardware settings will also abort the capture (clients should assume that any non-query command sent while a capture is in progress will abort the capture). To determine if the capture was aborted, check the output of STATus:OPERation?.
The capture will also be 'paused' if the instrument detects an overpower or overheat condition: in this situation, any pending TRAC:IQ:DATA? query will immediately return #0 and a device-specific error will be added to the SCPI error queue. When the condition is rectified (either by removing the source of the overpower and closing the overpower relay, or waiting for the instrument to cool down), the capture will automatically restart.
Additionally if the instrument detects a change in reference source (either due to a loss/acquisition of GPS or a connection/disconnection of external reference) a device-specific error will be added to the SCPI error queue.
In either capture mode, this command will do nothing if a capture is already in progress.
The device-specific errors this command adds to the SCPI error queue include a description that looks like the following:
Device-specific error;Reference source changed during capture @ Thu Jun 18 17:02:03 2015
Device-specific error;Capture paused due to overheating @ Thu Jun 18 17:02:03 2015
Device-specific error;Capture paused due to RF overpower @ Thu Jun 18 17:02:03 2015
Each description contains the reason for the error and a timestamp when the error occurred.
If the sweep mode (see SENSe:SWEep:MODe) is not currently FFT, this command will set it to FFT prior to starting the capture.
:MMEMory:LOAD:LIMit <string>,<string>,<string>
Title:
Load Limit From File
Description:
This command loads limit data from the specified limit file. The file location is resolved using the MSUS and file path parameters. Parameters:
1. Label: Used to specify which limit to load. Currently, the label only supports loading all limits. Send an empty string or "ALL" to load all limits.
2. File path: The file path (including file name) relative to the MSUS root directory. File path is case sensitive. File extension is optional.
3. MSUS: Device to load the file from. See MMEMory:MSUSs? for information on obtaining the list of available devices. MSUS parameter is case sensitive.
The model of the device that the limit was saved in must match the model of the the device to load in; otherwise, the load will be rejected.
Specifies the stop mode of the end of sweep save on event system. Setting the value to CONTinuous will cause the instrument to keep saving traces at the completion of every valid sweep. Setting the value to SINGle will trigger a save trace on the next complete valid sweep and then automatically turn the end of sweep save on event feature OFF.
Parameter(s):
<CONTinuous|SINGle>
Query Return:
CONT|SING
Default Value:
CONTinuous
:MMEMory:STOEvent:EOSWeep[:STATe] <0 | 1 | ON | OFF>
:MMEMory:STOEvent:EOSWeep[:STATe]?
Title:
End of Sweep Save on Event State
Description:
Turn the end of sweep save on event ON or OFF. Turning the feature on will cause the instrument to automatically save a trace whenever a sweep completes.
A common cause of the command failure is not having enough space available on the storage location. Use :MMEMory:CATalog:DIRectory query command to retrieve the total space available on the storage location.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
:MMEMory:STOEvent:LIMit:INTerval <numeric_value> {PS | NS | US | MS | S | MIN | HR} | DEFault | MINimum | MAXimum
Specifies the stop mode of thelimit save on event system. Setting the value to CONTinuous will cause the instrument to keep saving traces at every limit line failure. Setting the value to SINGle will trigger a save trace on the next limit line failure and then automatically turn the end of sweep save on event feature OFF automatically. Setting the value to INTerval will trigger a save on the next limit line failure and contiue to save at every end of sweep until the set time interval has expired.
Parameter(s):
<CONTinuous|SINGle|INTerval>
Query Return:
CONT|SING|INT
Default Value:
CONTinuous
:MMEMory:STOEvent:LIMit:PTRigger[:STATe] <0 | 1 | ON | OFF>
:MMEMory:STOEvent:LIMit:PTRigger[:STATe]?
Title:
Limit Pretrigger Save on Event State
Description:
Turn the limit pre-trigger save on event ON or OFF. Turning the feature ON will cause the instrument to automatically save a trace captured prior to the limit line failure trace. The :MMEMory:STOEvent:LIMit[:STATe] and :INITiate:CONTinuous needs to be turned ON for the pre-trigger feature to apply.
A common cause of the command failure is not having enough space available on the storage location. Use :MMEMory:CATalog:DIRectory query command to retrieve the total space available on the storage location.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
:MMEMory:STOEvent:LIMit[:STATe] <0 | 1 | ON | OFF>
:MMEMory:STOEvent:LIMit[:STATe]?
Title:
Limit Save on Event State
Description:
Turn the limit save on event ON or OFF. Turning the feature on will cause the instrument to automatically save a trace whenever a limit line failure occurs.
A common cause of the command failure is not having enough space available on the storage location. Use :MMEMory:CATalog:DIRectory query command to retrieve the total space available on the storage location.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
:MMEMory:STOEvent:TIMer:INTerval <numeric_value> {PS | NS | US | MS | S | MIN | HR} | DEFault | MINimum | MAXimum
Specify the total size, in bytes, the timer save on event will utilize. This feature prevents the save-on-event timer from filling the memory of the specified mass storage device. If the size specified is exceeded, subsequent timer expirations will cause the oldest save-on-event timer file to be deleted and replaced with the new measurement file.
The total size only applies to the current directory (as specified by :MMEMory:MSIS and :MMEMory:CDIRectory).
Query Return:
Numeric
Set Command Parameter(s):
<numeric_value> | DEFault | MINimum | MAXimum
Query Command Parameter(s):
[DEFault | MINimum | MAXimum]
Default Value:
1000000
Range:
1000 to 1000000000000
:MMEMory:STOEvent:TIMer[:STATe] <0 | 1 | ON | OFF>
:MMEMory:STOEvent:TIMer[:STATe]?
Title:
Limit Save on Event State
Description:
Turn the timer save on event ON or OFF. Turning the feature on will cause the instrument to automatically save a trace at the interval specified by :MMEMory:STOEvent:LIMit:INTerval, if space is available. Available memory may be checked using :MMEMory:CATalog:DIRectory query command.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
:MMEMory:STORe:LIMit <string>,<string>,<string>
Title:
Store Limit To File
Description:
This command stores the limit data into the specified file location. The file location is resolved using the MSUS and file path parameters. Intermediate folders specified by the file path parameter are automatically created. The output file extension is .lim. The command automatically overwrites the specified file if present. Parameters:
1. Label: Used to specify which limit to store. Currently, the label only supports storing all limits. Send an empty string or "ALL" to store all limits.
2. File path: The file path (including file name) relative to the MSUS root directory. File path is case sensitive. File extension is optional.
3. MSUS: Device to store the file to. See MMEMory:MSUSs? for information on obtaining the list of available devices. MSUS parameter is case sensitive.
A common cause of the command failure is not having enough space available on the storage location. Use :MMEMory:CATalog:DIRectory query command to retrieve the total space available on the storage location.
Store data to RAM from a file. This command takes three parameters
1. data block size: that needs to be stored in bytes (must be a word aligned)
2. offset: in bytes from start of RAM address to store data at
3. filename: name of the file without the full path. Contents of this file will be copied over to RAM
Parameter(s):
<numeric_value>,<numeric_value>,<string>
:OUTPut:IF:STATe <0 | 1 | ON | OFF>
:OUTPut:IF:STATe?
Title:
IF Output State
Description:
Toggles the analog IF output on/off.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
:READ:ACPower?
Title:
Read Adjacent Channel Power Ratio
Description:
Triggers a new adjacent channel power ratio measurement and returns the results: main channel power, lower adjacent and upper adjacent channel power. It is a combination of the commands :ABORT; :INITiate; :FETCh:ACPower? The channel power measurement must be the active measurement (specified by the command :CONFigure:ACPower). The current measurement can be queried using the command :CONFigure?
Data is returned as 9 comma-separated values: main channel power, absolute lower adjacent channel power, absolute upper adjacent channel power, absolute lower alternate channel power,absolute upper alternate channel power, relative lower adjacent channel power, relative upper adjacent channel power, relative lower alternate channel power,relative upper alternate channel power.
If the measurement is not active, the instrument will indicate error -400 and return the string "nan,nan,nan,nan,nan". If :INITiate command fails it returns a string "nan,nan,nan,nan,nan,nan,nan,nan,nan"
:READ:CHPower?
Title:
Read Channel Power And Density
Description:
Triggers a new channel power measurement and returns the results: channel power and channel power density. It is a combination of the commands :ABORT; :INITiate; :FETCh:CHPower? The channel power measurement must be the active measurement (specified by the command :CONFigure:CHPower).Data is returned as 2 comma-separat ed values: channel power, channel power density.If the measurement is not active, the instrument will indicate error -400 and return the string "nan,nan". If :INITiate command fails it returns a string "nan,nan"
:READ:CHPower:CHPower?
Title:
Read Channel Power And Density
Description:
Triggers a new channel power measurement and returns the channel power result: channel power and channel power density. It is a combination of the commands :ABORT; :INITiate; :FETCh:CHPower? The channel power measurement must be the active measurement (specified by the command :CONFigure:CHPower).Data returned is : channel power.If the measurement is not active, the instrument will indicate error -400 and return the string "nan" If :INITiate command fails it returns a string "nan"
:READ:CHPower:DENSity?
Title:
Read Channel Power And Density
Description:
Triggers a new channel power measurement and returns the results: channel power and channel power density. It is a combination of the commands :ABORT; :INITiate; :FETCh:CHPower? The channel power measurement must be the active measurement (specified by the command :CONFigure:CHPower).Data returned is : channel power density.If the measurement is not active, the instrument will indicate error -400 and return the string "nan". If :INITiate command fails it returns a string "nan"
:ROUTe:CPRI:CLOSe <numeric_value> | DEFault | MINimum | MAXimum
:ROUTe:CPRI:CLOSe? [DEFault | MINimum | MAXimum]
Title:
CPRI Antenna Container
Description:
Close the specified SFP channel, setting which SFP input to route from. Two SFPs are available but only one can be used at a time.
Query Return:
Numeric
Set Command Parameter(s):
<numeric_value> | DEFault | MINimum | MAXimum
Query Command Parameter(s):
[DEFault | MINimum | MAXimum]
Default Value:
1
Range:
1 to 2
:ROUTe:INPut:CLOSe <numeric_value>
:ROUTe:INPut:CLOSe? <numeric_value>
Title:
Switch RF Input
Description:
Set the port number of an Antenna Multiplexer Device. Both the set and query command take a parameter specifying a port number. The query version returns 1 if the specified port is currently set, otherwise it returns 0.Avaliable number of ports on the antenna multiplexer device is determined by model number and option number of the system
Parameter(s):
<numeric_value>
Query Return:
Numeric
Default Value:
1
Range:
1 to 24
:ROUTe:INPut:CLOSe:MODE <RECall|STATic>
:ROUTe:INPut:CLOSe:MODE?
Title:
Switch RF Input Recall Setup Mode
Description:
Sets whether the port specific setup will be recalled when switching the port number of the Antenna Multiplexer Device. Note that this setting is not persistent through a power cycle, but keeps the value through recalling user setup files or user measurement files. When recalling a user setup in the STATic mode, the setup of the Antenna Mux value in the setup file will be used as the static port setup when toggling Antenna Mux ports. The query returns either REC or STAT. If the setting is set to REC, the instrument will recall the port specific setup during every port change of the Antenna Multiplexer Device. A STAT setting value means that the port setup will not change when changing the port of the Antenna Multiplexer Device.
Parameter(s):
<RECall|STATic>
Query Return:
REC|STAT
Default Value:
RECall
:ROUTe:INPut:CLOSe:STATe?
Title:
Query RF Input Switch
Description:
Query the instrument for the state of the an Antenna Multiplexer Device. The response is in the form of a SCPI channel list (i.e. IEEE definite length arbitrary block response '#AX<block>', where A is the number of digits in X, X is the number of bytes in <block>, and <block> is the ASCII representation of the currently closed port).Avaliable number of ports on the antenna multiplexer device is determined by model number and option number of the system
Sets the effective number of averages and the length of the rolling min and max hold. Due to memory limitations the actual length of buffers for rolling min and max hold are limited to 2,000,000 / number of trace points.
Specifies how successive traces are combined to produce the resulting display value. Only applies to trace 1. Setting the TYPE to NORMal will cause the displayed value for a point to be the current measured value for that point. Setting the TYPE to AVERage will cause the displayed value for a point to be the average of the last <integer> measured values where <integer> is set by [:SENSe]:AVERage:COUNt. Setting the TYPE to MAXimum will cause the displayed value for a point is the maximum measured value for that point over sweeps. Setting the TYPE to MINimum will cause the displayed value for a point is the minimum measured value for that point over sweeps.Setting the TYPE to RMAXimum will cause the displayed value for a point to be the maximum of the last <integer> measured values where <integer> is set by [:SENSe]:AVERage:COUNt.Setting the TYPE to RMINimum will cause the displayed value for a point to be the minimum of the last <integer> measured values where <integer> is set by [:SENSe]:AVERage:COUNt.
Sets the ratio of the resolution bandwidth to the span for use when the resolution bandwidth to span coupling is enabled. Note that the front panel interface sets the inverse ratio: the span to the resolution bandwidth.
Query Return:
Numeric
Set Command Parameter(s):
<numeric_value> | DEFault | MINimum | MAXimum
Query Command Parameter(s):
[DEFault | MINimum | MAXimum]
Default Value:
0.01
Range:
1e-05 to 1
[:SENSe]:BANDwidth|BWIDth:SHAPe <FLATtop|NUTall>
[:SENSe]:BANDwidth|BWIDth:SHAPe?
Title:
Rbw Filter Type
Description:
This command sets the rbw filter type, Flat Top window or Nutall.
Sets the ratio of the video bandwidth to the resolution bandwidth for use when the video to resolution bandwidth coupling is enabled. Note that the front panel interface sets the inverse ratio: the resolution bandwidth to the video bandwidth which is an integer, in other words, if you send 0.35, the display will show 2 not 2.857
[:SENSe]:BANDwidth[:RESolution]:AUTO <0 | 1 | ON | OFF>
[:SENSe]:BANDwidth[:RESolution]:AUTO?
Title:
RBW Auto
Description:
Sets the state of the coupling of the resolution bandwidth to the frequency span. Setting the value to ON or 1 will result in the resolution bandwidth being coupled to the span. That is, when the span changes, the resolution bandwidth changes. Setting the value to OFF or 0 will result in the resolution bandwidth being un-coupled from the span. That is, changing the span will not change the resolution bandwidth. When this command is issued, the resolution bandwidth setting itself will not change
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
ON
[:SENSe]:BANDwidth:VIDeo:AUTO <0 | 1 | ON | OFF>
[:SENSe]:BANDwidth:VIDeo:AUTO?
Title:
VBW Auto
Description:
Sets the state of the coupling of the video bandwidth to the resolution bandwidth. Setting the value to ON or 1 will result in the video bandwidth being coupled to the resolution bandwidth. That is, when the resolution bandwidth changes, the video bandwidth changes. Setting the value to OFF or 0 will result in the video bandwidth being un-coupled from the resolution bandwidth. That is, changing the resolution bandwidth will not change the video bandwidth
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
ON
[:SENSe]:CAPTure:TIMe <numeric_value> {PS | NS | US | MS | S | MIN | HR} | DEFault | MINimum | MAXimum
Determines how much time to spend taking samples for each portion of the spectrum. Increasing the capture time is useful for detecting modulated signals (frequency or amplitude modulation). The query version of this command reports the setting value in milliseconds.
Query Return:
Numeric (ms)
Set Command Parameter(s):
<numeric_value> {PS | NS | US | MS | S | MIN | HR} | DEFault | MINimum | MAXimum
Returns actual time spent taking samples for each portion of the spectrum. The query version of this command reports the setting value in milliseconds.
Set the I/Q bit width used in the CPRI link. This value must match the configuration of the connected RRH (remote radio head) in order to make a valid measurement.
Only the following bit widths are available:
10, 12, 15, 16
Query Return:
Numeric
Set Command Parameter(s):
<numeric_value> | DEFault | MINimum | MAXimum
Query Command Parameter(s):
[DEFault | MINimum | MAXimum]
Default Value:
15
Range:
10 to 16
[:SENSe]:CPRI:IQ:BITS:REServe <numeric_value> | DEFault | MINimum | MAXimum
Set the number of reserve bits used in the CPRI link. This value must match the configuration of the connected RRH (remote radio head) in order to make a valid measurement.
Query Return:
Numeric
Set Command Parameter(s):
<numeric_value> | DEFault | MINimum | MAXimum
Query Command Parameter(s):
[DEFault | MINimum | MAXimum]
Default Value:
0
Range:
0 to 10
[:SENSe]:CPRI:LRATe <numeric_value> | DEFault | MINimum | MAXimum
Set the line rate of the CPRI link, in MBPS (million bits per second). This value must match the configuration of the connected RRH (remote radio head) in order to make a valid measurement.
Only the following rates are available (in MBPS):
614.4
1228.8
2457.6
3072
4915.2
6144
9830.4
10137.6
Query Return:
Numeric
Set Command Parameter(s):
<numeric_value> | DEFault | MINimum | MAXimum
Query Command Parameter(s):
[DEFault | MINimum | MAXimum]
Default Value:
2457.6
Range:
614.4 to 10137.6
[:SENSe]:DETector[:FUNCtion] <POS|RMS|NEG|SAMP>
[:SENSe]:DETector[:FUNCtion]?
Title:
Detection Mode
Description:
Sets the detection method for calculating each display point. Each display point represents several measurements. The detection type determines how the display point is derived from its associated measurements. POSitive Peak detection displays the maximum value of the associated measurements. RMS detection displays the average power of the associated measurements. NEGative Peak detection displays the minimum value of the associated measurements.
Sets the pre-selector to pass input through or to filter input in a specific frequency band. Setting the pre-selector to THRU passes the input without any filtering. Setting the pre-selector to BPF1 will filter out all input signals outside of the 88 MHz - 108 MHz band. Setting the pre-selector to BPF2 will filter out all input signals outside of the 600 MHz - 1200 MHz band. Setting the pre-selector to BPF3 will filer out all input signals outside of the 1600 MHz - 2800 MHz band. The query command will return the current pre-selector setting value as a short form enumerable value (THRU, BPF1, BPF2, or BPF3)
Sets the center frequency. Note that changing the value of the center frequency will change the value of the coupled parameters Start Frequency and Stop Frequency. It may also change the value of the span.
Set a frequency offset, which will be added to the start, stop, and center frequencies. This offset is for display purposes only and does not affect the frequency range being measured.
This command is only applicable when making CPRI measurements.
Sets the frequency span. Setting the value of <freq> to 0 Hz is the equivalent of setting the span mode to zero span. Note that changing the value of the frequency span will change the value of the coupled parameters Start Frequency and Stop Frequency and may change the Center Frequency.
Sets the frequency span to full span. Note that changing the value of the frequency span will change the value of the coupled parameters, Start Frequency and Stop Frequency and may change the Center Frequency.
[:SENSe]:FREQuency:SPAN:LAST
Title:
Set to Last Span
Description:
Sets the frequency span to the previous span value. Note that changing the value of the frequency span will change the value of the coupled parameters, Start Frequency and Stop Frequency and may change the Center Frequency.
Sets the start frequency. Note that in the spectrum analyzer, changing the value of the start frequency will change the value of the coupled parameters, Center Frequency and Span.
Set or query the step size to gradually increase or decrease frequency value. This command doesn't change any behavior in the backend but will be included in save/recall operations.
Sets the stop frequency. Note that in the spectrum analyzer, changing the value of the stop frequency will change the value of the coupled parameters, Center Frequency and Span.
This command sets/queries image rejection mode. NLOW sets local oscillator(LO) to lowside only. NHIGh sets LO to highside only. Default is NORMal which engages both high and low and applies the image rejection algorithm.
[:SENSe]:IQ:BITS <numeric_value> | DEFault | MINimum | MAXimum
[:SENSe]:IQ:BITS? [DEFault | MINimum | MAXimum]
Title:
IQ Bits per Sample
Description:
The number of IQ bits per sample. Lower values enable higher throughput (continuous IQ capture) or longer maximum capture length (block IQ capture). The number of samples per frame increases as the bits per sample decreases:
Bits per sample Samples per frame
24 1
16 2
10 3
8 4
Query Return:
Numeric
Set Command Parameter(s):
<numeric_value> | DEFault | MINimum | MAXimum
Query Command Parameter(s):
[DEFault | MINimum | MAXimum]
Default Value:
24
Range:
8 to 24
[:SENSe]:IQ:LENGth <numeric_value> {PS | NS | US | MS | S | MIN | HR} | DEFault | MINimum | MAXimum
[:SENSe]:IQ:LENGth? [DEFault | MINimum | MAXimum]
Title:
Capture Length
Description:
The set form of this command sets the iq length in milliseconds and query form returns the iq length in milliseconds
Query Return:
Numeric (ms)
Set Command Parameter(s):
<numeric_value> {PS | NS | US | MS | S | MIN | HR} | DEFault | MINimum | MAXimum
Query Command Parameter(s):
[DEFault | MINimum | MAXimum]
Default Value:
10000 ms
Default Unit:
ms
Range:
0.001 ms to 100000000 ms
[:SENSe]:IQ:MODE <SINGle|STREam>
[:SENSe]:IQ:MODE?
Title:
Capture Mode
Description:
Specifies the type of capture mode
1.Single mode does a single block capture
2.Streaming mode does real time streaming capture
Parameter(s):
<SINGle|STREam>
Query Return:
SING|STRE
Default Value:
SINGle
[:SENSe]:IQ:SAMPle:CALibration:CONFiguration?
Title:
IQ Sample Calibration Configuration
Description:
In order to get the valid IQ correction factor, user should issue MEAS:IQ:CAPT command first. Returns a comma delimited list of I/Q measurement configuration and calibration coefficients information with 7 fields:
Center frequency,
Preamp state,
Input attenuation,
IQ base sample rate,
Decimation factor,
IQ capture bandwidth,
IQ correction factor in dB,
An invalid value of -20000 is returned if any of Center frequency, Preamp state, Input attenuation, IQ capture bandwidth settings is modified after issuing MEAS:IQ:CAPT command
To apply the IQ correction factor, please refer to the Remote Spectrum Monitoring System Help Introduction. Information is avaliable in I/Q Capture Block Mode section of the manual(full path: Remote Spectrum Monitor/Programming with SCPI/I/Q Capture Block Mode)
[:SENSe]:IQ:SAMPle:CONFiguration?
Title:
IQ Configuration
Description:
Returns a comma delimited list of I/Q measurement configuration information with 5 fields:
Base sample rate,
Number of bytes per frame,
Effective bits per sample (see SENSE:IQ:BITS),
Decimation factor,
Timestamp (see SENSE:IQ:TIMESTAMP),
The base sample rate is generally fixed in a specific hardware revision; its value is provided here to enable calculation of the data rate, or time between samples, which is equal to the base sample rate divided by the decimation factor. The data rate is used when extrapolating embedded timestamps to other samples. For example, assuming a data rate of 1 MHz, if the nth sample contains an embedded timestamp of 1444753342s + 37531655ns, the n+1th sample would have an effective timestamp of 1444753342s + 37531655ns + (1/1MHz) = 1444753342s + 37531655ns + 1ms = 1444753342s + 37532655ns.
The number of samples per frame is calculated by:
floor(bitsPerFrame / bitsPerSample), where bitsPerFrame = 8 * bytesPerFrame
Decimation factor is read only, and its value is derived from the current capture bandwith setting. There is a 1-to-1 correspondence between an IQ:BAND value and a decimation factor.
Number of bytes per sample is 8 for I/Q and 2 for raw ADC capture. The raw ADC capture must be parsed differently. See TRAC:IQ:DATA? for the data format.
This command provides the information necessary for clients to reconstruct I/Q data samples and timestamps from the raw data returned by TRAC:IQ:DATA?.
[:SENSe]:IQ:TIMEstamps <0 | 1 | ON | OFF>
[:SENSe]:IQ:TIMEstamps?
Title:
IQ Timestamps
Description:
Enables or disables IQ timestamps. When I/Q timestamps are enabled, timestamps will be embedded in the binary response data returned by TRACe:IQ:DATA?. The first 256 frames of each 1024 frame chunk use the least-significant bit of each I and Q sample in each frame for timestamping.
If SENS:IQ:BITS is 24 or 10, the timestamp does not reduce resolution.
If SENS:IQ:BITS is 16 or 8, the timestamp reduces the resolution by one bit for 256/1024 frames.
In the 16 bit case, 256/2048 samples are 15 bits. In the 8 bit case, 256/4096 samples are 7 bits.
If SENS:IQ:TIMESTAMPS is OFF, then the IQ data cannot be absolutely positioned in time, but all samples have full resolution.
This setting is ignored if SENSE:IQ:BITS is 24 or 10 bits because there are extra, otherwise unused bits.
The timestamps are shift-encoded in groups of 64 in bit 0, and there is a shift-encoded mark in bit 32.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
ON
[:SENSe]:MODe <SPECtrum|NRADio>
[:SENSe]:MODe?
Title:
Spa mode
Description:
Set the operational mode of the Spa app. SPECtrum for the default spectrum mode. NRADio for 5G demodulation measurements
Parameter(s):
<SPECtrum|NRADio>
Query Return:
SPEC|NRAD
Default Value:
SPECtrum
[:SENSe]:OBWidth:METHod <XDB|PERCent>
[:SENSe]:OBWidth:METHod?
Title:
Occupied Bandwidth Method
Description:
Sets the method for calculating occupied bandwidth. XDB calculates the occupied bandwidth based on points a specified number of dB below the carrier. Issue command [:SENSe]:OBWidth:XDB to set the number of dB to be used. PERCent calculates the occupied bandwidth based on points a specified percentage of the carrier power below the carrier. Issue command [:SENSe]:OBWidth:PERCent to set the percentage to be used.
The measurement always gives a result, even if there is no signal. For example, the 100 dBc Occupied Bandwidth is the current full span.
Parameter(s):
<XDB|PERCent>
Query Return:
XDB|PERC
Default Value:
PERCent
[:SENSe]:OBWidth:PERCent <numeric_value> | DEFault | MINimum | MAXimum
This command sets the percentage of carrier power used to measure the occupied bandwidth. This value is used in the measurement if :SENSe:OBWidth:METHod is set to PERCent.
Query Return:
Numeric
Set Command Parameter(s):
<numeric_value> | DEFault | MINimum | MAXimum
Query Command Parameter(s):
[DEFault | MINimum | MAXimum]
Default Value:
99
Range:
1e-06 to 99.999999
[:SENSe]:OBWidth:STATe <0 | 1 | ON | OFF>
[:SENSe]:OBWidth:STATe?
Title:
Occupied Bandwidth State
Description:
Sets the state of the occupied bandwidth measurement, ON or OFF. When using :CONFigure:OBWidth, the state is automaticaly set to ON
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
[:SENSe]:OBWidth:XDB <numeric_value> {DB} | DEFault | MINimum | MAXimum
This command sets the number of dB below the carrier used to measure the occupied bandwidth. This value is used in the measurement if :SENSe:OBWidth:METHod is set to XDB.
See UNIT:POWer to query or set the current amplitude units.
Query Return:
Numeric (dB)
Set Command Parameter(s):
<numeric_value> {DB} | DEFault | MINimum | MAXimum
Query Command Parameter(s):
[DEFault | MINimum | MAXimum]
Default Value:
3 dB
Default Unit:
dB
Range:
0.001 dB to 100 dB
[:SENSe]:POWer:RF:ATTenuation <numeric_value> {DB} | DEFault | MINimum | MAXimum
Sets the input attenuation. Note that issuing this command will set the automatic input attenuation OFF.
See UNIT:POWer to query or set the current amplitude units.
Query Return:
Numeric (dB)
Set Command Parameter(s):
<numeric_value> {DB} | DEFault | MINimum | MAXimum
Query Command Parameter(s):
[DEFault | MINimum | MAXimum]
Default Value:
30 dB
Default Unit:
dB
Range:
0 dB to 50 dB
[:SENSe]:POWer:RF:ATTenuation:AUTO <0 | 1 | ON | OFF>
[:SENSe]:POWer:RF:ATTenuation:AUTO?
Title:
RF Attenuation Auto
Description:
Sets the input attenuation coupling. Setting the value to ON or 1 will result in the input attenuation being coupled to the reference level. Setting the value to OFF or 0 will result in the input attenuation being uncoupled from the reference level. That is, changing the reference level will not change the input attenuation. When this command is issued, the input attenuator setting itself will not change. The default value is ON. That is, sending :SENS:POW:ATT:AUTO is equivalent to sending :SENS:POW:ATT:AUTO ON.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
ON
[:SENSe]:POWer:RF:GAIN:STATe <0 | 1 | ON | OFF>
[:SENSe]:POWer:RF:GAIN:STATe?
Title:
Preamp
Description:
Sets the state of the preamp. Note that this may cause a change in the reference level and/or attenuation.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
:STATus:OPERation[:EVENt]?
Title:
Get Operation Status
Description:
This command requests information about the current status of the instrument. Each bit of the return value represents some operation. Only a subset of the bits are implemented for each application. The number returned is the decimal representation of the bit-wise OR of the enabled bits:
Bit Decimal Value Description
0 1 Not implemented
1 2 Not implemented
2 4 Not implemented
3 8 Not implemented
4 16 Not implemented
5 32 Not implemented
6 64 Not implemented
7 128 Not implemented
8 256 Sweep Complete
This bit is set to 0 when the command :INITiate[:IMMediate] is sent to trigger a sweep. It will have a value of 1 when the sweep has completed.
9 512 I/Q Capture
This bit indicates whether the instrument is currently capturing I/Q data. It is set to 1 when the MEAS:IQ:CAPT command is issued. This bit will be set to 0 when the capture is completed normally (in block mode), or is aborted, either due to the ABORt command or some other command which invalidates the capture.
Set the instrument to a preconfigured setup for a particular radio.
This command will set the CPRI Bit Width and Reserve Bits to the correct values needed to receive data from the specified radio manufacturer and band.
This command takes one of the following parameters: EULink|EDLink|ALCatel|HULink|HDLink
These parameters correspond to the following radio configurations:
Value Meaning Bit Width Reserve Bits
EULink Ericsson UL 12 6
EDLink Ericsson DL 15 0
ALCatel Alcatel UL&DL 15 0
HULink Huawei UL 12 0
HDLink Huawei DL 15 0
Parameter(s):
<EULink|EDLink|ALCatel|HULink|HDLink>
:TRACe<n>:IQ:DATA? [<numeric_value>]
Title:
IQ Data
Description:
This command transfers IQ data from the instrument to the controller. Data is transferred from the instrument as an IEEE definite length arbitrary block response, which has the form <header><block>.
For a detailed description of the response format, see TRACe:IQ:DATA:FORMat?.
If IQ:MODE? is STREAM, this command will block until the next block of streaming data is available, then return it. If IQ:MODE? is SINGle, this command will return data immediately if a capture has been already completed, or it will wait for an in-progress capture to complete before returning data, or it will return #0 if a capture has never been started.
Regardless of capture mode, this command will return #0 if an error condition is encountered during an in-progress capture (see MEAS:IQ:CAPT). Clients should check the SCPI error queue with SYST:ERR:NEXT? to determine what action to take.
In streaming mode there is an optional numeric parameter for the max chunks of data to return for cases where the read can't keep up.
Parameter(s):
[<numeric_value>]
TRACe Suffix Range:
0, Default = 0
:TRACe:CLEar <numeric_value>
Title:
Trace Clear
Description:
This command clears the trace's history and current sweep data. Trace history refers to the previous trace data used to calculate trace types such as min/max hold and averaging.
Parameter(s):
<numeric_value>
:TRACe:CLEar:ALL
Title:
All Traces Clear
Description:
This command clears the trace history and current sweep data for all traces. Trace history refers to the previous data used to calculate trace types such as min/max hold and averaging.
:TRACe[:DATA]? <numeric_value>
Title:
Trace Data
Description:
This command transfers trace data from the instrument to the controller. Data is transferred from the instrument as an IEEE definite length arbitrary block response, which has the form <header><block>.
This command takes a single integer parameter specifying the trace number to transfer. If the parameter value is out of the range of valid trace numbers, the first trace (1) will be transferred. (Currently only one trace is supported, so this parameter has no effect.)
The binary block header specifies the number of data bytes. It looks like #AX, where A is the number of digits in X and X is the number of bytes in the <block>.
The first character is the literal ascii hash '#' 043. The second character (A) is a single ascii digit '1' to '9' describing the number of bytes in the length section (X). This number is called nlength. The next nlength bytes make up an ascii string of digits '1' to '9' describing the length of the <block> data.
For example, if the first 6 bytes are #49999, then the nlength is 4. The 4 bytes of length are 9999. After that follows the <block>, which would be 9999 bytes in size.
The format of the block data depends on the current data format setting (FORMat[:TRACe][:DATA]). The number of amplitudes returned is equal to the current number of display points (DISPlay:POINtcount).
The query command will return a #0 if data is invalid for the active trace.
Parameter(s):
<numeric_value>
:TRACe:IQ:DATA:FORMat <PACKed|ASCii>
:TRACe:IQ:DATA:FORMat?
Title:
IQ Data Format
Description:
This command selects the data format for transferring I/Q data via the TRACe:IQ:DATA? query.
Supported data formats include PACKed, which is a binary format that includes embedded timestamps, and ASCii, which is a human-readable, comma-delimited list of samples. The PACKed format is recommended for applications that require precision timestamps, high data throughput, and processing in real time, such as TDOA. The ASCii format can be much slower to transfer, but it has the advantage of being human readable.
When the data format is PACKed, TRAC:IQ:DATA? query uses SCPI standard (IEEE 488.2) definite length block data format for responses. The data format is '#AXD', where X is one or more ASCII digits specifying the number of bytes in D, and A is a single ASCII digit specifying the number of digits in X. D contains binary data. The whole 'D' part looks like 'L
B', where L is an ASCII string of the form 'latitude, longitude' in decimal degrees, '
' is a single byte newline delimiter marking the end of the GPS location component, and B is the I/Q data taken from the instrument's RAM. The binary structure of B includes timestamps embedded within the samples and is described in detail in the I/Q Data Format Description document published on the Library tab of this product's official web page (http://www.anritsu.com/en-US/Products-Solutions/Test-Measurement/Mobile-Wireless-Communications/Interference-Hunter/index.aspx).
The values of the GPS latitude and longitude in the header are undefined if the GPS is not actually fixed (i.e. FETCH:GPS? returns "NO FIX").
When the data format is ASCii, TRAC:IQ:DATA? query returns an definite length block data response in Comma Separated Values (CSV) Standard File Format, which is easily imported into popular spreadsheet programs:
* Each record is on one line
* Lines are separated by carriage return and line feed (CRLF)
* Fields are separated by commas
* Trailing and leading whitespace is insignificant
* No quotes, embedded commas, or embedded newlines in this output
The data format is '#AXD' where X is one or more ASCII digits specifying the number of bytes in D, and A is the number of digits in X. D contains a list of I/Q samples. Each of I and Q are formatted as signed decimal integers. Each I is separated from its corresponding Q by a comma. Adjacent samples are separated by newlines. So, the data (excluding the '#AX' header) looks like:
I1,Q1
I2,Q2
I3,Q3
...
The ASCii format response contains neither time stamp nor header. To get the GPS location, see the FETCh:GPS? query.
Parameter(s):
<PACKed|ASCii>
Query Return:
PACK|ASC
Default Value:
PACKed
:TRACe:MEASurement? <numeric_value>
Title:
Trace Data
Description:
This command transfers measurement status and trace data from the instrument to the controller. Data is transferred from the instrument as an IEEE definite length arbitrary block response, which has the form <header><block>.
This command takes a single integer parameter specifying the trace number to transfer. If the parameter value is out of the range of valid trace numbers, the first trace (1) will be transferred. (Currently only one trace is supported, so this parameter has no effect.)
The binary block header specifies the number of data bytes. It looks like #AX, where A is the number of digits in X and X is the number of bytes in the <block>.
The first character is the literal ascii hash '#' 043. The second character (A) is a single ascii digit '1' to '9' describing the number of bytes in the length section (X). This number is called nlength. The next nlength bytes make up an ascii string of digits '1' to '9' describing the length of the <block> data.
For example, if the first 6 bytes are #49999, then the nlength is 4. The 4 bytes of length are 9999. After that follows the <block>, which would be 9999 bytes in size.
A JSON header follows the block header. It's a single JSON object {"ADC Overrange Count":number,"Any Measurement Error":number} Order of the key:value pairs is not guaranteed.
The format of the trace data depends on the current data format setting (FORMat[:TRACe][:DATA]). The number of amplitudes returned is equal to the current number of display points (DISPlay:POINtcount).
The query command will return a #0 if data is invalid for the active trace.
Parameter(s):
<numeric_value>
:TRACe:PRESet:ALL
Title:
Preset All Trace
Description:
This command preset all traces which turn Traces 2-6 off and set Trace 1 to Clear/Write, Active, Peak Detector.
:TRACe:SELect <numeric_value> | DEFault | MINimum | MAXimum
:TRACe:SELect? [DEFault | MINimum | MAXimum]
Title:
Select Trace
Description:
The selected trace will be used by operations that use a single trace.
Query Return:
Numeric
Set Command Parameter(s):
<numeric_value> | DEFault | MINimum | MAXimum
Query Command Parameter(s):
[DEFault | MINimum | MAXimum]
Default Value:
1
Range:
1 to 1
:TRACe:STATus? <numeric_value>
Title:
Trace Status
Description:
This command returns a response of the same format as a valid TRACe[:DATA] response, except that instead of amplitude, each comma-delimited value is a decimal integer representing the bitwise-OR of one or more status bits. Each bit of the integer is set according to the table below to indicate that the corresponding trace point has the indicated status:
Bit Decimal Value Description
0 1 ADC Overrange
1 Not Implemented Not Implemented
2 Not Implemented Not Implemented
3 8 LO1 Lock Failure
4 16 LO2 Lock Failure
5 32 TG LO Lock Failure
6 64 Limit Failure
7-31 Not Implemented Not Implemented
Parameter(s):
<numeric_value>
:TRIGger[:SEQuence]:ATRigger <numeric_value> {PS | NS | US | MS | S | MIN | HR} | DEFault | MINimum | MAXimum
The trigger source indicates whether or not to look for a trigger condition before making measurements. VIDeo trigger is only valid for zero span operation.
Parameter(s):
<EXTernal|IMMediate|VIDeo>
Query Return:
EXT|IMM|VID
Default Value:
IMMediate
:TRIGger[:SEQuence]:VIDeo:HYSTeresis <numeric_value> {DB} | DEFault | MINimum | MAXimum
A relative amplitude value in dBm centered around the video trigger level which the input signal must cross for a trigger event to occur when trigger source is set to video (TRIG:SOUR VID).
See UNIT:POWer to query or set the current amplitude units.
Query Return:
Numeric (dB)
Set Command Parameter(s):
<numeric_value> {DB} | DEFault | MINimum | MAXimum
Query Command Parameter(s):
[DEFault | MINimum | MAXimum]
Default Value:
0 dB
Default Unit:
dB
Range:
0 dB to 200 dB
:TRIGger[:SEQuence]:VIDeo:LEVel <numeric_value> {<amplitude_units>} | DEFault | MINimum | MAXimum