Remote Spectrum Monitor™ MS27201A Programming Manual : MS27201A Commands : Spectrum Analyzer Commands
 
Spectrum Analyzer Commands
:ABORt
Title:
Abort
Description:
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:LIMit<n>:COMMent <string>
:CALCulate: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).
Note that this command is not available for Spectral Emission Mask measurement.
Parameter(s):
<string>
LIMit Suffix Range:
1-10, Default = 1
:CALCulate:LIMit<n>:CONTrol[:DATA] <numeric_value> {HZ | KHZ | MHZ | GHZ}, {<numeric_value> {HZ | KHZ | MHZ | GHZ}}, ...
:CALCulate:LIMit<n>:CONTrol[:DATA]?
Title:
Limit Control Data
Description:
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: CALC:LIM1:CONT:DATA 1MHz, 10MHz, 9.91e37, 20MHz, 30MHz
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, CALC:LIM1:CONT:UPP 0dBm, 10dBm, 9.91e37, 10dBm, 0dBm
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.
Note that this command is not available for Spectral Emission Mask measurement.
Parameter(s):
<numeric_value> {HZ | KHZ | MHZ | GHZ}, {<numeric_value> {HZ | KHZ | MHZ | GHZ}}, ...
LIMit Suffix Range:
1-10, Default = 1
:CALCulate:LIMit<n>:CONTrol:MODE <ABSolute|RELative>
:CALCulate:LIMit<n>:CONTrol:MODE?
Title:
Limit Control Mode
Description:
Choose either ABSolute or RELative limit.
In ABSolute mode, the control value of the limit line is defined by absolute physical values (Hz).
In RELative mode, the control value of the limit line is relative to the center frequency (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).
Note that this command is not available for Spectral Emission Mask measurement.
Parameter(s):
<ABSolute|RELative>
Query Return:
ABS|REL
LIMit Suffix Range:
1-10, Default = 1
Default Value:
ABSolute
:CALCulate:LIMit<n>:CONTrol:SHIFt <numeric_value> {HZ | KHZ | MHZ | GHZ}
Title:
Limit Control Shift
Description:
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).
Note that this command is not available for Spectral Emission Mask measurement.
Parameter(s):
<numeric_value> {HZ | KHZ | MHZ | GHZ}
LIMit Suffix Range:
1-10, Default = 1
:CALCulate: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).
Note that this command is not available for Spectral Emission Mask measurement.
Parameter(s):
<numeric_value>
LIMit Suffix Range:
1-10, Default = 1
:CALCulate: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).
Note that this command is not available for Spectral Emission Mask measurement.
LIMit Suffix Range:
1-10, Default = 1
:CALCulate: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).
LIMit Suffix Range:
1-10, Default = 1
:CALCulate:LIMit<n>:LOWer[:DATA] <numeric_value> {<amplitude_units>}, {<numeric_value> {<amplitude_units>}}, ...
:CALCulate:LIMit<n>:LOWer[:DATA]?
Title:
Lower Limit Data
Description:
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 +/-infinity (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.
Note that if the units for the limit values are specified (as shown in the example above), they must have the same unit.
Note that this command is not available for Spectral Emission Mask measurement.
See UNIT:POWer to query or set the current amplitude units.
Parameter(s):
<numeric_value> {<amplitude_units>}, {<numeric_value> {<amplitude_units>}}, ...
LIMit Suffix Range:
1-10, Default = 1
:CALCulate:LIMit<n>:LOWer:MODE <ABSolute|RELative>
:CALCulate:LIMit<n>:LOWer:MODE?
Title:
Limit Lower Mode
Description:
Choose either ABSolute or RELative limit.
In ABSolute mode, the control value of the limit line is defined by absolute physical values (dBm).
In RELative mode, the control value of the limit line is relative to the reference level (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).
Note that this command is not available for Spectral Emission Mask measurement.
Parameter(s):
<ABSolute|RELative>
Query Return:
ABS|REL
LIMit Suffix Range:
1-10, Default = 1
Default Value:
ABSolute
:CALCulate:LIMit<n>:LOWer:SHIFt <numeric_value> {DB}
Title:
Lower Limit Shift
Description:
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).
Note that this command is not available for Spectral Emission Mask measurement.
See UNIT:POWer to query or set the current amplitude units.
Parameter(s):
<numeric_value> {DB}
LIMit Suffix Range:
1-10, Default = 1
:CALCulate:LIMit<n>:LOWer:STATe <0 | 1 | ON | OFF>
:CALCulate: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).
Note that this command is not available for Spectral Emission Mask measurement.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
LIMit Suffix Range:
1-10, Default = 1
Default Value:
OFF
:CALCulate:LIMit<n>:NAME <string>
:CALCulate: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).
Note that this command is not available for Spectral Emission Mask measurement.
Parameter(s):
<string>
LIMit Suffix Range:
1-10, Default = 1
:CALCulate:LIMit<n>:STATe <0 | 1 | ON | OFF>
:CALCulate: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).
Note that this command is not available for Spectral Emission Mask measurement.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
LIMit Suffix Range:
1-10, Default = 1
Default Value:
OFF
:CALCulate:LIMit<n>:TRACe<n>:CHECk <0 | 1 | ON | OFF>
:CALCulate: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).
Note that this command is not available for Spectral Emission Mask measurement.
Parameter(s):
<0 | 1 | ON | OFF>
LIMit Suffix Range:
1-10, Default = 1
TRACe Suffix Range:
1-6, Default = 1
:CALCulate:LIMit<n>:UPPer[:DATA] <numeric_value> {<amplitude_units>}, {<numeric_value> {<amplitude_units>}}, ...
:CALCulate:LIMit<n>:UPPer[:DATA]?
Title:
Upper Limit Data
Description:
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 +/-infinity (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.
Note that if the units for the limit values are specified (as shown in the example above), they must have the same unit.
Note that this command is not available for Spectral Emission Mask measurement.
See UNIT:POWer to query or set the current amplitude units.
Parameter(s):
<numeric_value> {<amplitude_units>}, {<numeric_value> {<amplitude_units>}}, ...
LIMit Suffix Range:
1-10, Default = 1
:CALCulate:LIMit<n>:UPPer:MODE <ABSolute|RELative>
:CALCulate:LIMit<n>:UPPer:MODE?
Title:
Upper Limit Mode
Description:
Choose either ABSolute or RELative limit.
In ABSolute mode, the control value of the limit line is defined by absolute physical values (dBm).
In RELative mode, the control value of the limit line is relative to the reference level (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).
Note that this command is not available for Spectral Emission Mask measurement.
Parameter(s):
<ABSolute|RELative>
Query Return:
ABS|REL
LIMit Suffix Range:
1-10, Default = 1
Default Value:
ABSolute
:CALCulate:LIMit<n>:UPPer:SHIFt <numeric_value> {DB}
Title:
Upper Limit Shift
Description:
Move the upper limit up or down by a relative amplitude. This command changes the value of :CALCulate<n>:LIMit<k>:UPPer[:DATA].
Issuing this command multiple times will change the limits each time. For example, sending
CALC:LIM1:UPP:SHIFT 1 dB
CALC:LIM1:UPP:SHIFT 1 dB
CALC:LIM1:UPP:SHIFT 1 dB
CALC:LIM1:UPP:SHIFT 1 dB
CALC:LIM1:UPP:SHIFT 1 dB
will shift the upper 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).
Note that this command is not available for Spectral Emission Mask measurement.
See UNIT:POWer to query or set the current amplitude units.
Parameter(s):
<numeric_value> {DB}
LIMit Suffix Range:
1-10, Default = 1
:CALCulate:LIMit<n>:UPPer:STATe <0 | 1 | ON | OFF>
:CALCulate:LIMit<n>:UPPer:STATe?
Title:
Upper Limit State
Description:
Turns ON or OFF the upper 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).
Note that this command is not available for Spectral Emission Mask measurement.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
LIMit Suffix Range:
1-10, Default = 1
Default Value:
OFF
:CALCulate:LIMit:ACTive?
Title:
Limit Active
Description:
Queries the numbers of all active limit lines in ascending order. This command returns a empty string if no limits are active.
Note that this command is not available for Spectral Emission Mask measurement.
:CALCulate:ACPower:LIMit:ADJacent:ABSolute <numeric_value> {<amplitude_units>}
:CALCulate:ACPower:LIMit:ADJacent:ABSolute?
Title:
Adjacent Channel Power Adjacent Absolute Limit
Description:
Sets and queries the amplitude of absolute limit for ACPR adjacent power.
See UNIT:POWer to query or set the current amplitude units.
Parameter(s):
<numeric_value> {<amplitude_units>}
Query Return:
Numeric (<amplitude_units>)
Default Value:
10 dBm
Default Unit:
dBm
Range:
-200 dBm to 200 dBm
:CALCulate:ACPower:LIMit:ADJacent:LOWer:FAIL?
Title:
ACPR Limit Adjacent Lower Fail
Description:
This command queries the result of a limit check
on lower adjacent channel power
:CALCulate:ACPower:LIMit:ADJacent:RELative <numeric_value> {DB}
:CALCulate:ACPower:LIMit:ADJacent:RELative?
Title:
Adjacent Channel Power Adjacent Relative Limit
Description:
Sets and queries the amplitude of relative limit for ACPR adjacent power.
See UNIT:POWer to query or set the current amplitude units.
Parameter(s):
<numeric_value> {DB}
Query Return:
Numeric (dB)
Default Value:
10 dB
Default Unit:
dB
Range:
-200 dB to 200 dB
:CALCulate:ACPower:LIMit:ADJacent:UPPer:FAIL?
Title:
ACPR Limit Adjacent Upper Fail
Description:
This command queries the result of a limit check
on upper adjacent channel power
:CALCulate:ACPower:LIMit:ALTernate:ABSolute <numeric_value> {<amplitude_units>}
:CALCulate:ACPower:LIMit:ALTernate:ABSolute?
Title:
Adjacent Channel Power Alternate Absolute Limit
Description:
Sets and queries the amplitude of absolute limit for ACPR alternate power.
See UNIT:POWer to query or set the current amplitude units.
Parameter(s):
<numeric_value> {<amplitude_units>}
Query Return:
Numeric (<amplitude_units>)
Default Value:
10 dBm
Default Unit:
dBm
Range:
-200 dBm to 200 dBm
:CALCulate:ACPower:LIMit:ALTernate:LOWer:FAIL?
Title:
ACPR Limit Alternate Lower Fail
Description:
This command queries the result of a limit check
on lower alternate channel power
:CALCulate:ACPower:LIMit:ALTernate:RELative <numeric_value> {DB}
:CALCulate:ACPower:LIMit:ALTernate:RELative?
Title:
Adjacent Channel Power Alternate Relative Limit
Description:
Sets and queries the amplitude of relative limit for ACPR alternate power.
See UNIT:POWer to query or set the current amplitude units.
Parameter(s):
<numeric_value> {DB}
Query Return:
Numeric (dB)
Default Value:
10 dB
Default Unit:
dB
Range:
-200 dB to 200 dB
:CALCulate:ACPower:LIMit:ALTernate:UPPer:FAIL?
Title:
ACPR Limit Alternate Upper Fail
Description:
This command queries the result of a limit check
on upper alternate channel power
:CALCulate:ACPower:LIMit:FAIL?
Title:
ACPR Limit Fail
Description:
This command queries the result of a limit check
on adjacent channel power ratio
:CALCulate:ACPower:LIMit:MAIN <numeric_value> {<amplitude_units>}
:CALCulate:ACPower:LIMit:MAIN?
Title:
Adjacent Channel Power Main Limit
Description:
Sets and queries the amplitude of limit for main power.
See UNIT:POWer to query or set the current amplitude units.
Parameter(s):
<numeric_value> {<amplitude_units>}
Query Return:
Numeric (<amplitude_units>)
Default Value:
10 dBm
Default Unit:
dBm
Range:
-200 dBm to 200 dBm
:CALCulate:ACPower:LIMit:MODE <ABSolute|RELative>
:CALCulate:ACPower:LIMit:MODE?
Title:
Adjacent Channel Power Limit Mode
Description:
Sets the ACPR limit mode to be absolute or relative
Parameter(s):
<ABSolute|RELative>
Query Return:
ABS|REL
Default Value:
ABSolute
:CALCulate:ACPower:LIMit:STATe <0 | 1 | ON | OFF>
:CALCulate:ACPower:LIMit:STATe?
Title:
Adjacent Channel Power Limit State
Description:
Sets the ACPR limit state to be ON or OFF
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
:CALCulate:CHPower:LIMit <numeric_value> {<amplitude_units>}
:CALCulate:CHPower:LIMit?
Title:
Channel Power Limit
Description:
Sets and queries the amplitude of limit on channel power.
See UNIT:POWer to query or set the current amplitude units.
Parameter(s):
<numeric_value> {<amplitude_units>}
Query Return:
Numeric (<amplitude_units>)
Default Value:
10 dBm
Default Unit:
dBm
Range:
-200 dBm to 70 dBm
:CALCulate:CHPower:LIMit:FAIL?
Title:
Channel Power Limit Fail
Description:
This command queries the result of a limit check
on channel power
:CALCulate:CHPower:LIMit:PSDensity <numeric_value> {<amplitude_units>}
:CALCulate:CHPower:LIMit:PSDensity?
Title:
Channel Power Spectral Density Limit
Description:
Sets and queries the amplitude of limit on channel power spectral density.
See UNIT:POWer to query or set the current amplitude units.
Parameter(s):
<numeric_value> {<amplitude_units>}
Query Return:
Numeric (<amplitude_units>)
Default Value:
10 dBm
Default Unit:
dBm
Range:
-200 dBm to 70 dBm
:CALCulate:CHPower:LIMit:PSDensity:STATe <0 | 1 | ON | OFF>
:CALCulate:CHPower:LIMit:PSDensity:STATe?
Title:
Channel Power Spectral Density Limit State
Description:
Sets and queries the state of limit on channel power spectral density. The set form of this command sets the limit state to be ON or OFF
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
:CALCulate:CHPower:LIMit:PSD:FAIL?
Title:
Power Spectral Density Limit Fail
Description:
This command queries the result of a limit check
on channel power spectral density
:CALCulate:CHPower:LIMit:STATe <0 | 1 | ON | OFF>
:CALCulate:CHPower:LIMit:STATe?
Title:
Channel Power Limit State
Description:
Sets and queries the state of limit on channel power. The set form of this command sets the limit state to be ON or OFF
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
:CALCulate:EIRPower:HORizontal:LIMit:FAIL?
Title:
Horizontal EIRP Limit Pass/Fail
Description:
This command queries the result of the Horizontal EIRP limit check. The query returns 1 for fail and 0 for pass.
:CALCulate:EIRPower:HORizontal:SAVE
Title:
Save Horizontal EIRP
Description:
Saves the active trace's EIRP value as the Horizontal EIRP. Recalculates Sum EIRP. Use :FETCh:EIRPower to query new Horizontal and SUM values.
:CALCulate:EIRPower:LIMit:FAIL?
Title:
EIRP Limit Pass/Fail
Description:
This command queries the result of a limit check on EIRP. The query returns 1 for fail and 0 for pass.
:CALCulate:EIRPower:LIMit:LOWer <numeric_value> {<amplitude_units>}
:CALCulate:EIRPower:LIMit:LOWer?
Title:
EIRP Lower Limit
Description:
This command sets or queries the EIRP Lower limit. The query returns the EIRP lower limit in the current amplitude unit.
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:
-99 dBm to 100 dBm
:CALCulate:EIRPower:LIMit:LOWer:STATe <0 | 1 | ON | OFF>
:CALCulate:EIRPower:LIMit:LOWer:STATe?
Title:
EIRP Lower Limit State
Description:
This command sets or queries the EIRP lower limit state. The query returns 1 if the lower limit state is On, otherwise 0.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
:CALCulate:EIRPower:LIMit:UPPer <numeric_value> {<amplitude_units>}
:CALCulate:EIRPower:LIMit:UPPer?
Title:
EIRP Upper Limit
Description:
This command sets or queries the EIRP upper limit. The query returns the EIRP upper limit in the current amplitude unit.
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:
-99 dBm to 100 dBm
:CALCulate:EIRPower:LIMit:UPPer:STATe <0 | 1 | ON | OFF>
:CALCulate:EIRPower:LIMit:UPPer:STATe?
Title:
EIRP Upper Limit State
Description:
This command sets or queries the EIRP upper limit state. The query returns 1 if the upper limit state is On, otherwise 0.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
:CALCulate:EIRPower:MAXimum:LIMit:FAIL?
Title:
MAXimum EIRP Limit Pass/Fail
Description:
This command queries the result of the maximum EIRP limit check. The query returns 1 for fail and 0 for pass.
:CALCulate:EIRPower:SUM:LIMit:FAIL?
Title:
Sum EIRP Limit Pass/Fail
Description:
This command queries the result of the SUM EIRP limit check. The query returns 1 for fail and 0 for pass.
:CALCulate:EIRPower:VERTical:LIMit:FAIL?
Title:
Vertical EIRP Limit Pass/Fail
Description:
This command queries the result of the Vertical EIRP limit check. The query returns 1 for fail and 0 for pass.
:CALCulate:EIRPower:VERTical:SAVE
Title:
Save Vertical EIRP
Description:
Saves the active trace's EIRP value as the Vertical EIRP. Recalculates Sum EIRP. Use :FETCh:EIRPower to query new Vertical and SUM values.
:CALCulate:LIMit<n>:ENVelope:UPDate:Y
Title:
Update Limit Envelope Amplitude
Description:
This command updates the amplitude of the upper and lower limits without changing the frequencies of the inflection points.
Note that this command is not available for Spectral Emission Mask measurement.
LIMit Suffix Range:
1-10, Default = 1
:CALCulate:LIMit<n>:LOWer:ENVelope:CREate
Title:
Create Lower Limit Envelope
Description:
This command is used to create an Lower limit envelope on the selected trace.
Note that this command is not available for Spectral Emission Mask measurement.
LIMit Suffix Range:
1-10, Default = 1
:CALCulate:LIMit<n>:LOWer[:TRACe]:POINts?
Title:
Lower Limit Points
Description:
This command queries the lower 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. Points which are not covered by the limit will be 'inf'.
Note that this command is not available for Spectral Emission Mask measurement.
LIMit Suffix Range:
1-10, Default = 1
:CALCulate:LIMit<n>:UPPer:ENVelope:CREate
Title:
Create Upper Limit Envelope
Description:
This command is used to create an Upper limit envelope on the selected trace.
Note that this command is not available for Spectral Emission Mask measurement.
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. Points which are not covered by the limit will be 'inf'.
Note that this command is not available for Spectral Emission Mask measurement.
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.
Note that this command is not available for Spectral Emission Mask measurement.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
:CALCulate:LIMit:ENVelope:OFFSet <numeric_value> {<amplitude_units>}
:CALCulate:LIMit:ENVelope:OFFSet?
Title:
Limit Envelope Offset
Description:
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.
Note that this command is not available for Spectral Emission Mask measurement.
See UNIT:POWer to query or set the current amplitude units.
Parameter(s):
<numeric_value> {<amplitude_units>}
Query Return:
Numeric (<amplitude_units>)
Default Value:
3 dBm
Default Unit:
dBm
Range:
-100 dBm to 100 dBm
:CALCulate:LIMit:ENVelope:POINt <numeric_value>
:CALCulate:LIMit:ENVelope:POINt?
Title:
Number of Limit Envelope Points
Description:
This command sets the number of inflection point for the limit envelope.
Note that this command is not available for Spectral Emission Mask measurement.
Parameter(s):
<numeric_value>
Query Return:
Numeric
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.
Note that this command is not available for Spectral Emission Mask measurement.
Parameter(s):
<SQUare|SLOPe>
Query Return:
SQU|SLOP
Default Value:
SQUare
:CALCulate:MARKer<n>:FUNCtion <OFF|NOISe|FCOunter|QUASi>
: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|FCOunter|QUASi>
Query Return:
OFF|NOIS|FCO|QUAS
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 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 highest peak to the RIGHT of the current X position of the marker.
MARKer Suffix Range:
1-12, Default = 1
:CALCulate:MARKer<n>:MODE <POSition|DELTa|FIXed>
:CALCulate:MARKer<n>:MODE?
Title:
Marker Mode
Description:
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.
Parameter(s):
<POSition|DELTa|FIXed>
Query Return:
POS|DELT|FIX
MARKer Suffix Range:
1-12, Default = 1
Default Value:
POSition
: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>:STATe <0 | 1 | ON | OFF>
:CALCulate:MARKer<n>:STATe?
Title:
Marker State
Description:
Turns the selected marker on or off.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
MARKer Suffix Range:
1-12, Default = 1
Default Value:
OFF
:CALCulate:MARKer<n>:TRACe <numeric_value>
:CALCulate:MARKer<n>:TRACe?
Title:
Marker Trace
Description:
Changes the trace to which the marker is currently attached.
Parameter(s):
<numeric_value>
Query Return:
Numeric
MARKer Suffix Range:
1-12, Default = 1
Default Value:
1
Range:
1 to 6
:CALCulate:MARKer<n>:X <numeric_value> {HZ | KHZ | MHZ | GHZ}
:CALCulate:MARKer<n>:X?
Title:
Marker Position
Description:
Sets the marker frequency.
Parameter(s):
<numeric_value> {HZ | KHZ | MHZ | GHZ}
Query Return:
Numeric (Hz)
MARKer Suffix Range:
1-12, Default = 1
Default Value:
200000000000 Hz
Default Unit:
Hz
Range:
-400000000000 Hz to 300000000000 Hz
:CALCulate:MARKer<n>:X <numeric_value> {PS | NS | US | MS | S | MIN | HR}
:CALCulate:MARKer<n>:X?
Title:
Marker Position Zero Span
Description:
Sets the marker time.
Parameter(s):
<numeric_value> {PS | NS | US | MS | S | MIN | HR}
Query Return:
Numeric (ms)
MARKer Suffix Range:
1-12, Default = 1
Default Value:
29999.99 ms
Default Unit:
ms
Range:
-1000 ms to 61670 ms
:CALCulate:MARKer<n>:Y <numeric_value> {<amplitude_units>}
:CALCulate:MARKer<n>:Y?
Title:
Marker Value
Description:
Set/Get the marker Y value. The user defined Y maker value will be applied only if the marker is in Fixed mode.
See UNIT:POWer to query or set the current amplitude units.
Parameter(s):
<numeric_value> {<amplitude_units>}
Query Return:
Numeric (<amplitude_units>)
MARKer Suffix Range:
1-12, Default = 1
Default Value:
10 dBm
Default Unit:
dBm
Range:
-250 dBm to 130 dBm
:CALCulate:MARKer:AOFF
Title:
Marker All Off
Description:
Turns all markers off.
:CALCulate:MARKer:APReset
Title:
Marker Preset
Description:
Presets all markers to their preset values.
:CALCulate:MARKer[:DATA]:ALL?
Title:
All Marker Data
Description:
Returns the last stored X and Y values of all markers. The response format is (marker1.x, marker1.y), (marker2.x, marker2.y), ... (markern.x, markern.y). Returns (0,nan) if the marker has never been turned on or the marker is preset.
:CALCulate:MARKer:FUNCtion:FCOunter:RESolution <R0|R1|R2|R3>
:CALCulate:MARKer:FUNCtion:FCOunter:RESolution?
Title:
Frequency Counter Marker Resolution
Description:
This command specifies the desired counter marker frequency resolution.
Value Resolution
R0 1 Hz
R1 100 mHz
R2 10 mHz
R3 1 mHz
Parameter(s):
<R0|R1|R2|R3>
Query Return:
R0|R1|R2|R3
Default Value:
R0
:CALCulate:MARKer:PEAK:EXCursion <numeric_value> {DB}
:CALCulate:MARKer:PEAK:EXCursion?
Title:
Marker Excursion
Description:
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.
Parameter(s):
<numeric_value> {DB}
Query Return:
Numeric (dB)
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>}
:CALCulate:MARKer:PEAK:THReshold?
Title:
Marker Threshold
Description:
Sets the threshold level for a marker. The threshold is the level that a peak must exceed to be considered a peak in marker max commands.
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:
-200 dBm to 100 dBm
:CALCulate:MARKer:PEAK:THReshold:STATe <0 | 1 | ON | OFF>
:CALCulate:MARKer:PEAK:THReshold:STATe?
Title:
Marker Threshold State
Description:
Turn on/off threshold checking for marker max commands.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
:CALCulate:OBW:LIMit <numeric_value> {HZ | KHZ | MHZ | GHZ}
:CALCulate:OBW:LIMit?
Title:
OBW Limit
Description:
Sets and queries the frequency limit on occupied bandwidth power.
Parameter(s):
<numeric_value> {HZ | KHZ | MHZ | GHZ}
Query Return:
Numeric (Hz)
Default Value:
10000 Hz
Default Unit:
Hz
Range:
1000 Hz to 300000000000 Hz
:CALCulate:OBW:LIMit:FAIL?
Title:
OBW Limit Fail
Description:
This command queries the result of a limit check
on occupied bandwidth power
:CALCulate:OBW:LIMit:STATe <0 | 1 | ON | OFF>
:CALCulate:OBW:LIMit:STATe?
Title:
OBW Power Limit State
Description:
Sets and queries the state of limit on occupied bandwidth power. The set form of this command sets the limit state to be ON or OFF
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
:CONFigure:ACPower
Title:
Configure Adjacent Channel Power Ratio
Description:
Configures and enables the default adjacent channel power ratio measurement. Disables channel power and occupied bandwidth measurements. 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 and enables the default channel power measurement. Disables ACPR and occupied bandwidth measurements. 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:EIRPower
Title:
Configure EIRP
Description:
Configures the EIRP measurement. This will disable other Spectrum measurements, configure a normal peak detect trace, and set the instrument in a single sweep mode (:INITiate:CONTinuous: OFF). Measurement settings can be modified by using the [:SENSe]:EIRPower commands before initiating a sweep.
:CONFigure:OBWidth
Title:
Configure Occupied Bandwidth
Description:
Configures and enables the default occupied bandwidth measurement. Disables channel power and ACPR measurements. 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.
:CONFigure:SEMask
Title:
Configure Spectral Emission Mask Measurement
Description:
Configures and enables the Spectral Emission Mask measurement. This will disable all other measurements, set the span to mask width, set the detection method to RMS, and set the instrument in a single sweep mode (:INITiate:CONTinuous OFF). Measurement settings can be modified by using the [:SENSe]:SEMask commands before initiating a sweep.
: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>
:DISPlay:POINtcount?
Title:
Display Point Count
Description:
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.
Parameter(s):
<numeric_value>
Query Return:
Numeric
Default Value:
501
Range:
10 to 4001
:DISPlay:VIEW:SPECtrogram:AADJust
Title:
Spectrogram Scale Auto Adjust
Description:
Automatically adjusts the spectrogram scale reference and bottom amplitude to the max and min amplitudes, respectively, of the most recent trace data collected.
:DISPlay:VIEW:SPECtrogram:BOTTom <numeric_value> {<amplitude_units>}
:DISPlay:VIEW:SPECtrogram:BOTTom?
Title:
Spectrogram Scale Bottom
Description:
The spectrogram scale bottom indicates the amplitude that corresponds to the least intense color in the spectrogram waterfall display. This is used in conjunction with the spectrogram scale reference command to establish the color gradient scale.
See UNIT:POWer to query or set the current amplitude units.
Parameter(s):
<numeric_value> {<amplitude_units>}
Query Return:
Numeric (<amplitude_units>)
Default Value:
-90 dBm
Default Unit:
dBm
Range:
-150 dBm to 30 dBm
:DISPlay:VIEW:SPECtrogram:HISTory[:DATA]? <numeric_value>
Title:
Spectrogram History Data
Description:
This command transfers the spectrogram history from the instrument to the client.
This command takes an integer parameter specifying the last trace ID received by client and returns all trace data after the received trace ID in a binary block response. The binary block response is formatted as below
History Header: (20 bytes)
Number Of Traces: 4 bytes, unsigned integer
Number Of Trace Points Per Trace : 4 bytes, unsigned integer
Last trace ID in the block: 4 bytes, unsigned integer
Reserved: 8 bytes
History Body:
Block of trace points formatted as a 4 byte, single-precision floating point value for each point. The history body size (in bytes) can be calculated as: <Number Of Traces> * (<Number Of Trace Points Per Trace> * 4).
If no new trace data was found in history, this command will return header only binary block with all zeros except <last trace ID in the block> is set to the last trace ID received by client.
Parameter(s):
<numeric_value>
:DISPlay:VIEW:SPECtrogram:HISTory:ELAPsed? <numeric_value>
Title:
Spectrogram History Elapsed
Description:
Provides the time values for the specified index in spectrogram history. Returns a negative value if the specified index is invalid.
Parameter(s):
<numeric_value>
:DISPlay:VIEW:SPECtrogram:HUE <numeric_value>
:DISPlay:VIEW:SPECtrogram:HUE?
Title:
Spectrogram Hue
Description:
The spectrogram hue command indicates the color that represents the highest amplitude in the spectrogram waterfall display. All of the other amplitudes are represented by colors starting at this hue setting and following a color wheel.
Parameter(s):
<numeric_value>
Query Return:
Numeric
Default Value:
0
Range:
0 to 359
:DISPlay:VIEW:SPECtrogram:REFerence <numeric_value> {<amplitude_units>}
:DISPlay:VIEW:SPECtrogram:REFerence?
Title:
Spectrogram Scale Reference
Description:
The spectrogram scale reference indicates the amplitude that corresponds to the most intense color in the spectrogram waterfall display. This is used in conjunction with the spectrogram scale bottom command to establish the color gradient scale.
See UNIT:POWer to query or set the current amplitude units.
Parameter(s):
<numeric_value> {<amplitude_units>}
Query Return:
Numeric (<amplitude_units>)
Default Value:
10 dBm
Default Unit:
dBm
Range:
-150 dBm to 30 dBm
:DISPlay:VIEW:SPECtrogram:TRACe:SELection <POSition|TIME>
:DISPlay:VIEW:SPECtrogram:TRACe:SELection?
Title:
Cursor Selection
Description:
Selects which time cursor setting to use, position or time. For position, the DISP:VIEW:SPEC:POS setting will be used to determine which trace from the spectrogram history to show. For time, the DISP:VIEW:SPEC:TIME setting will be used instead.
Parameter(s):
<POSition|TIME>
Query Return:
POS|TIME
Default Value:
POSition
:DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision <numeric_value>
:DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision?
Title:
Scale Per Division
Description:
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.
Parameter(s):
<numeric_value>
Query Return:
Numeric
Default Value:
10
Range:
1 to 15
:DISPlay[:WINDow]:TRACe:Y:SCALe:RLEVel <numeric_value> {<amplitude_units>}
:DISPlay[:WINDow]:TRACe:Y:SCALe:RLEVel?
Title:
Reference Level
Description:
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.
Parameter(s):
<numeric_value> {<amplitude_units>}
Query Return:
Numeric (<amplitude_units>)
Default Value:
10 dBm
Default Unit:
dBm
Range:
-150 dBm to 30 dBm
:DISPlay[:WINDow]:TRACe:Y[:SCALe]:RLEVel:AUTO[:IMMediate] <numeric_value> {DB}
Title:
Automatic Reference Level
Description:
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}
:DISPlay[:WINDow]:TRACe:Y[:SCALe]:RLEVel:OFFSet?
Title:
Reference Level Offset
Description:
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.
Parameter(s):
<numeric_value> {DB}
Query Return:
Numeric (dB)
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 (see [:SENSe]:CHPower:STATe) then, the instrument will indicate error -400 and return the string "nan,nan,nan,nan,nan,nan,nan,nan,nan"
:FETCh:AMPLitude? <numeric_value> {HZ | KHZ | MHZ | GHZ}
Title:
Fetch Amplitude
Description:
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:CAGGregation?
Title:
Fetch Carrier Aggregation Measurements
Description:
Returns the Carrier Aggregation measurement results for each carrier in a JSON format. Each carrier measurement result will include the Carrier Id, measurement name, and measurement results. If a measurement is in progress, it blocks until the measurement is completed. Data is available only up to the available number of carriers, the rest will be an empty JSON. See command [:SENSe]:CAGGregation:CARRier:COUNt to set or query the number of carriers. An example of Carrier Aggregation measurement in 5GNR is as follows (Please refer to the individual measurement for further example):
{
"CarrierAggregationResults":
[{"CarrierId":1,
"PciMeasurement":[{...}],
"SsbMeasurement":[{...]},
]},
{},{},{},{},{},{},{}]}
: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 (see [:SENSe]:CHPower:STATe) then, the instrument will indicate error -400 and return the string "nan,nan"
:FETCh:CHPower:CHPower?
Title:
Fetch Channel Power
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 (see [: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 (see [:SENSe]:CHPower:STATe) then, the instrument will indicate error -400 and return the string "nan,nan"
:FETCh:CONStellation:PBCH?
Title:
Fetch PBCH Constellation
Description:
Get the latest Physical Broadcast Channel (PBCH) constellation hitmap results for the selected beam after waiting for the current measurement to complete. Beam selection is performed using the [:SENSe]:CONStellation:PBCH:BEAM command. The results are in JSON format with the hitmap represented as an array of arrays [I,Q,C] where I = real coordinate, Q = imaginary coordinate, and C = hit count. An example response looks like this, but real responses will likely have many more values than shown here:
{
"qpsk":[[0.673828,0.697266,1],[-0.732422,-0.720703,1],[0.708984,-0.720703,5]],
"carrierId":1
}
In NRAD mode, there will be an additional key-value pair indicating the selected beam number.
"beam":17
:FETCh:CONStellation:PDSCh?
Title:
Fetch Data Channel Constellation
Description:
Get the latest Physical Downlink Shared Channel (PDSCH) constellation results after waiting for the current measurement to complete. The results are in JSON format with the hitmap represented as an array of arrays [I,Q,C] where I = real coordinate, Q = imaginary coordinate, and C = hit count. Only constellations that match the selected modulation type (see [:SENSe]:MODulation:TYPE) are returned. An example response looks like this, but real responses will likely have many more values than shown here:
{
"carrierId":1,
"qam64":[[0.779297,-0.427734,1],[0.169922,0.439453,1],[0.169922,-0.181641,1]],
}
:FETCh:CONTrol?
Title:
Fetch Control Channel Measurement
Description:
Returns the Control Channel measurements in json format. This includes Sync, Reference, Broadcast and Control channel measurements. If a measurement is in progress, it blocks until complete.
{
"antennaOneOn":true,
"antennaThreeOn":true,
"antennaTwoOn":false,
"antennaZeroOn":false,
"carrierId":1,
"cellId":91,
"cellIdGroup":30,
"cfi":2,
"correctedCarrierFrequency":-201,
"detectedAntennaCount":1,
"detectedCpType":1,
"frameStart":123456,
"frequencyError":-200,
"gps":{
"coordinates":"37.146865, -121.656103,112m",
"time":"Sat Aug 31 00:44:13 2020 GMT"
},
"pbch":{
"evm":{
"peakEvm":{
"percent":15,
"subcarrierNumber":3,
"symbolNumber":4
},
"rmsEvm":3
},
"power":{
"perReWatts":1.1939880550926317e-09,
"perReDBM":-59.23000017958162,
"totalWatts":9.885530971587295e-10,
"totalDBM":-60.04999998900905
}
},
"pcfich":{
"evm":{
"peakEvm":{
"percent":25,
"subcarrierNumber":10,
"symbolNumber":0
},
"rmsEvm":5
},
"power":{
"perReWatts":3.0902954222256074e-09,
"perReDBM":-55.10000001445821,
"totalWatts":9.549926289764696e-10,
"totalDBM":-60.19999980465677
}
},
"pdcch":{
"evm":{
"peakEvm":{
"percent":35,
"subcarrierNumber":56,
"symbolNumber":1
},
"rmsEvm":7
},
"power":{
"perReWatts":1.4125375855655877e-09,
"perReDBM":-58.499999874118416,
"totalWatts":6.095368689784659e-10,
"totalDBM":-62.15000020136438
}
},
"phich":{
"evm":{
"peakEvm":{
"percent":30,
"subcarrierNumber":20,
"symbolNumber":1
},
"rmsEvm":6
},
"power":{
"perReWatts":1.892343561848973e-09,
"perReDBM":-57.230000130347314,
"totalWatts":7.533555503869141e-10,
"totalDBM":-61.230000076941664
}
},
"ppmFrequencyError":200000000,
"pss":{
"evm":{
"peakEvm":{
"percent":5,
"subcarrierNumber":1,
"symbolNumber":2
},
"rmsEvm":1
},
"power":{
"perReWatts":7.063175644361763e-10,
"perReDBM":-61.509999937447816,
"totalWatts":2.259435859741644e-09,
"totalDBM":-56.459999827929025
}
},
"rs":{
"evm":{
"peakEvm":{
"percent":20,
"subcarrierNumber":4,
"symbolNumber":0
},
"rmsEvm":4
},
"power":{
"perReWatts":7.277797976712457e-09,
"perReDBM":-51.38000004096958,
"totalWatts":1.224616244144273e-08,
"totalDBM":-49.11999984084157
}
},
"sectorId":1,
"sss":{
"evm":{
"peakEvm":{
"percent":10,
"subcarrierNumber":2,
"symbolNumber":3
},
"rmsEvm":2
},
"power":{
"perReWatts":1.2941958402734608e-09,
"perReDBM":-58.880000003948076,
"totalWatts":1.0715192502175336e-09,
"totalDBM":-59.700000223000316
}
},
"status":{
"hardwareErrors":{
"ADCOverRange":0,
"DeviceAccess":0,
"EEPROM":0,
"IrregularData":0,
"Limit":0,
"LockLO1":0,
"LockLO2":0,
"NoCal":0,
"Overpower":0,
"SLOLock":0,
"Saturation":0,
"TgLockLo1":0
},
"overallStatusMessage":"statusControlChanMeasDone",
"overallStatusNumber":19
"statusMessage": "statusPciDone",
"statusNumber": 10
},
"timeOffset":1000
"totalNonSharedChannelsPowerWatts":5.260172838461585e-08,
"totalNonSharedChannelsPowerDBM":-42.78999985588293}
}
:FETCh[:DATA]:ALL? [<ASCII|INTeger|REAL>],[<numeric_value>]
Title:
Fetch Trace Data All
Description:
This command transfers trace data and trace status data from the instrument to the controller for all traces with display state ON (see Trace Display State commands), as well as measurement data for the currently active measurement (see ":DISPlay:MEASurement") in JSON format.
An optional parameter can be given to set the format data output, the parameter follows the same enumerable value as the Trace Data format setting. When using REAL as the output format, the numeric value field is required. See the document on Trace Data Format (:FORMat[:TRACe][:DATA]) for more info.
The returned response is formatted as a list of packets, each of which has a header detailing its contents. A single value (numeric ASCII if ASCII format is specified, or uint8 otherwise) precedes the packet list that specifies the number of packets contained in the response. Overall format is as follows:
<IEEE definite length arbitrary block header><Number of packets:uint8><Packet #1><Packet #2>...<Packet #N>
The headers of each packet are either in a comma-separated list if the user requests ASCII format, or in binary otherwise. The individual packets are formatted as follows (value order is preserved between binary and ASCII):
<Header Length:uint16><Packet Type:uint8><Trace number:uint8><Packet Data Payload Length:uint32><DataFormat:uint8> <Zero Padding:3 Bytes><Data Payload>
Packet type is represented as: 0 -> Trace Data, 1 -> Trace Status, 2 -> JSON Measurement data
Data Format is represented as: 0 -> ASCII, 1 -> Integer32, 2 -> Real32, 3 -> Real64
The measurement data is in a JSON format with an extra item added under the key "measurementName" indicating the active measurement.
Parameter(s):
[<ASCII|INTeger|REAL>],[<numeric_value>]
:FETCh:EIRPower?
Title:
Fetch EIRP
Description:
This command returns the current EIRP, Max EIRP, Horizontal EIRP, Vertical and Sum EIRP results in dBm. 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: EIRP power, Max power. If the measurement is not active, the instrument will indicate error -400 and return the string "nan,nan".
:FETCh:EIRPower:DATA?
Title:
Fetch Current EIRP
Description:
This command returns the current EIRP measurement result in dBm.
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 active, the instrument will indicate error -400 and return the string "nan".
:FETCh:EIRPower:MAXimum?
Title:
Fetch MAXimum EIRP
Description:
This command returns the maximum EIRP measurement result in dBm.
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 active, the instrument will indicate error -400 and return the string "nan".
:FETCh:FRAMe:POWer?
Title:
Fetch Frame Power Analysis Measurements
Description:
Returns the latest Frame Power Analysis measurements in json format. {
"carrierId":1,
"dwPtsPower":-11.686997248037647,
"framePowerDisplay":{
"displayPoints":4001,
"startTime":0,
"stopTime":0
},
"gps":{
"coordinates":"37.146865, -121.656103,112m",
"time":"Sat Aug 31 00:44:13 2020 GMT"
},
"status":{
"hardwareErrors":{
"ADCOverRange":0,
"DeviceAccess":0,
"EEPROM":0,
"IrregularData":0,
"Limit":0,
"LockLO1":0,
"LockLO2":0,
"NoCal":0,
"Overpower":0,
"SLOLock":0,
"Saturation":0,
"TgLockLo1":0
},
"statusMessage":"statusFramePowerMeasDone",
"statusNumber":27
},
"subframePowers":[-11.689188015956093,-12.716933625147382,-62.51848880635962,-62.53143933862779,-61.67019300047982,
-11.670055450451763,-11.670313553247079,-11.664923673930858,-11.665172925879165,-11.664404801000856],
"slotPower":{
"slotPower": [-80.54065996005235,-81.64280984558984,-89.53351755973559,-92.06537520209018,-87.16220702208979,-86.59842952593326,-90.09767346186983,-90.4888434578913,-87.21263721353337,-87.07058138343614,-85.63481509445133,-87.44050546781867,-85.96719348317012,-85.75635347781137,-88.8697573461123,-90.30780137936135,-87.33643988270461,-87.64654104952463,-87.83688674927848,-89.51407913594818],
}, },
"timingError":null,
"guardPeriodPower": nan,
"txTransmitOffPower": nan,
"totalPower":-13.354569314227396,
"traceMeasurementPower":[-7.5062150955200195,-6.351113319396973,...,-11.05777645111082,-10.479146957397464]},
"upPtsPower":-62.51650224671434,
"possibleSsfConfigsList":[ssf0,ssf3]
}
:FETCh:MIMO:ANTennas?
Title:
Fetch MIMO Antennas
Description:
Returns the sync power measurements in json format. If a measurement is in progress, it blocks until complete.
{
"antennaOneOn":true,
"antennaOnePower":-83.17574100587828,
"antennaThreeOn":true,
"antennaThreePower":-83.66073582353636,
"antennaTwoOn":false,
"antennaTwoPower":null,
"antennaZeroOn":false,
"antennaZeroPower":null,
"carrierId":1,
"detectedAntennaCount":2,
"gps":{
"coordinates":"nan, nan,nanm",
"time":""
},
"status":{
"hardwareErrors":{
"ADCOverRange":0,
"DeviceAccess":0,
"EEPROM":0,
"IrregularData":0,
"Limit":0,
"LockLO1":0,
"LockLO2":0,
"NoCal":0,
"Overpower":0,
"SLOLock":0,
"Saturation":0,
"TgLockLo1":0
},
"statusMessage":"statusAntDetectionDone",
"statusNumber":14
}
}
: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:PCI?
Title:
Fetch PCI Measurements
Description:
Returns the PCI measurements. This command returns cell id, group id, corrected carrier frequency, detected beam,
frame start, frequency error, sector id, group id, and time offset(in ns) as output in json format.
If a measurement is in progress, it blocks until complete.
An example is as follows:
{
"carrierId":1,
"cellId": 0,
"cellIdGroup": 0,
"correctedCarrierFrequency": 4499999985.264854,
"detectedBeam": 4,
"frameStart": 233097,
"frequencyError": -14.735145792134368,
"ppmFrequencyError": 0.09346635883256266,
"sectorId": 0,
"status": {
"hardwareErrors": {
"ADCOverRange": 0,
"DeviceAccess": 0,
"EEPROM": 0,
"IrregularData": 0,
"Limit": 0,
"LockLO1": 0,
"LockLO2": 0,
"NoCal": 0,
"Overpower": 0,
"SLOLock": 0,
"Saturation": 0,
"TgLockLo1": 0
},
"statusMessage": "statusPciDone",
"statusNumber": 10
},
"gps":{
"coordinates":"37.14681, -121.65609, 128m",
"time":"Fri Jun 28 19:56:45 2019 GMT"
},
"timeOffset": -634782.9687499882
}
:FETCh:PDSCh?
Title:
Fetch Data Channel Measurement
Description:
Returns the Data Channel measurements in json format.
If a measurement is in progress, it blocks until complete.
{
"activeRbCount":-1,
"carrierId":1,
"gps":{
"coordinates":"37.146865, -121.656103,112m",
"time":"Sat Aug 31 00:44:13 2019 GMT"
},
"ostp":-27.704519932556128,
"percentUtilization":17.430730819702148,
"qam16":{
"peakEvm":{
"percent":13.430730819702148,
"subcarrierNumber":12,
"symbolNumber":5
},
"percentUtilization":0.89,
"rmsEvm":1.7515575885772705
},
"qam256":{
"peakEvm":{
"percent":13.430730819702148,
"subcarrierNumber":12,
"symbolNumber":5
},
"percentUtilization":1.0,
"rmsEvm":1.7515575885772705
},
"qam64":{
"peakEvm":{
"percent":13.430730819702148,
"subcarrierNumber":12,
"symbolNumber":5
},
"percentUtilization":0,
"rmsEvm":1.7515575885772705
},
"qpsk":{
"peakEvm":{
"percent":13.430730819702148,
"subcarrierNumber":12,
"symbolNumber":5
},
"percentUtilization":95,
"rmsEvm":1.7515575885772705
},
"pdschPeakEvm":8.5812377270588576,
"pdschRmsEvm":1.7515575885772705,
"status":{
"hardwareErrors":{
"ADCOverRange":0,
"DeviceAccess":0,
"EEPROM":0,
"IrregularData":0,
"Limit":0,
"LockLO1":0,
"LockLO2":0,
"NoCal":0,
"Overpower":0,
"SLOLock":0,
"Saturation":0,
"TgLockLo1":0
},
"statusMessage":"statusDataChanMeasDone",
"statusNumber":20
}
}
: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.
:FETCh:RRM?
Title:
Fetch RRM Measurements
Description:
Returns the Radio Resource Management(RRM) measurements in json format.
RRM measurements are comprised of RSRP, RSRQ, and SINR which are computed using the Cell Reference Signals (CRS).
If a measurement is in progress, it blocks until complete.
:FETCh:SCANner?
Title:
Fetch Cell Scanner
Description:
Returns the cell scanner measurements in a json format. If a measurement is in progress, it blocks until completed. Returned data format varies based on whether the current mode is 5GNR or LTE.
5GNR Mode format:
{
"carrierId":1,
"gps":{
"coordinates":"37.14681, -121.65609, 128m",
"time":"Fri Jun 28 19:56:45 2019 GMT"
},
"status":{
"hardwareErrors":{
"ADCOverRange":0,
"DeviceAccess":0,
"EEPROM":0,
"IrregularData":0,
"Limit":0,
"LockLO1":0,
"LockLO2":0,
"NoCal":0,
"Overpower":0,
"SLOLock":0,
"Saturation":0,
"TgLockLo1":0
},
"statusMessage":"statusCellScannerDone",
"statusNumber":13
},
"values":[
{
"cellId":1007,
"cellIdGroup":335,
"frameStart":1920521,
"sectorId":0,
"timeOffset":-3490194.091145895,
"values":[
{
"beamIndex":0,
"beamPresent":1,
"ssRmsEvm":6.488177299499512,
"ssRsrp":-67.18608535715634,
"ssRsrq":-9.913812153567978,
"ssSinr":23.757546218871823
},
...
{
"beamIndex":7,
"beamPresent":1,
"ssRmsEvm":6.488177299499512,
"ssRsrp":-84.22420720274197,
"ssRsrq":null,
"ssSinr":null
}
]
}
]
}
LTE Mode format:
{
"carrierId":1,
"gps":{
"coordinates":"nan, nan,nanm","time":""
},
"status":{
"hardwareErrors":{
"ADCOverRange":0,
"DeviceAccess":0,
"EEPROM":0,
"IrregularData":0,
"Limit":0,
"LockLO1":0,
"LockLO2":0,
"NoCal":0,
"Overpower":0,
"SLOLock":0,
"Saturation":0,
"TgLockLo1":0
},
"statusMessage":"statusCellScannerDone",
"statusNumber":13
},
"values":[
{
"cellId":2,
"cellIdGroup":0,
"crsRsrp":-68.46522521972656,
"crsRsrq":0.2733601927757263,
"crsSinr":34.74685287475586,
"antPortUsedForMeas":0,
"dominance":null,
"dominantCell":true,
"frameStart":-1,
"frequencyError":227.3341827392578,
"pbch":{
"peakEvm":{
"percent":4.949735641479492,
"subcarrierNumber":-1,
"symbolNumber":-1
},
"rmsEvm":2.2826967239379883
},
"ppmFrequencyError":0.06495262363978795,
"sectorId":2,
"ssRsrp":-68.43709564208984
}
]
}
:FETCh:SEMask?
Title:
Fetch Spectral Emission Mask
Description:
This command returns the current Spectral Emission Mask mesurement result. 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 an empty JSON object and 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 ASCII of JSON object that consists of reference power, reference channel power, and an array of segment information. The following is the format of the response: { "referencePwr": <amplitude value>, "referenceChannelPwr": <amplitude value>, "segments": [{"setup": {"rbw": <frequency value>, "points": [{"x": <frequency value>, "y": <amplitude value>}, {"x": <frequency value>, "y": <amplitude value>}]}, "result": {"peakPwr": <amplitude value>, "peakFreq": <amplitude value>, "pass": <true|false>}}, { ... }]
} If the measurement is not active, the instrument will indicate error -400 and return an empty object.
:FETCh:SSB?
Title:
Fetch SSB Measurements
Description:
Returns the SSB measurements.
This command returns the beam numbers with the best EVM and power, followed by Power and EVM results
for PSS, SSS, PBCH, PBCH DM-RS and SS Signal Quality Results in a json format.
If a measurement is in progress, it blocks until complete.
eg:
{
"bestEvmBeam":5,
"bestPowerBeam":0,
"carrierId":1,
"status": {
"hardwareErrors": {
"ADCOverRange": 0,
"DeviceAccess": 0,
"EEPROM": 0,
"IrregularData": 0,
"Limit": 0,
"LockLO1": 0,
"LockLO2": 0,
"NoCal": 0,
"Overpower": 0,
"SLOLock": 0,
"Saturation": 0,
"TgLockLo1": 0
},
"statusMessage": "statusPciDone",
"statusNumber": 10
},
"gps":{
"coordinates":"37.14681, -121.65609, 128m",
"time":"Fri Jun 28 19:56:45 2019 GMT"
},
"values":[
{
"dmRsPbch":{
"peakEvm":{
"percent":11.926020622253418,
"subcarrierNumber":1529,
"symbolNumber":3
},
"power":-31.813847928749347,
"rmsEvm":3.813983917236328
},
"pbch":{
"peakEvm":{
"percent":13.430730819702148,
"subcarrierNumber":1638,
"symbolNumber":5
},
"power":-31.8139914869584,
"rmsEvm":3.736370325088501
},
"pss":{
"peakEvm":{
"percent":12.912864685058594,
"subcarrierNumber":1638,
"symbolNumber":2
},
"power":-31.704519932556128,
"rmsEvm":1.7515575885772705
},
"ssRsrp":-31.750750515723816,
"ssRsrq":-10.728772378478801,
"ssSinr":-13.878087163543444,
"sss":{
"peakEvm":{
"percent":11.369827270507812,
"subcarrierNumber":1638,
"symbolNumber":4
},
"power":-31.750750515723816,
"rmsEvm":2.5253000259399414
}
},
{ ... },
{ ... },
{ ... },
{ ... },
{ ... },
{ ... },
{ ... }
]
}
:FETCh:SYNC:EVM?
Title:
Fetch Sync EVM
Description:
Returns the Sync EVM measurements in json format.
If a measurement is in progress, it blocks until complete.
{
"carrierId":1,
"gps":{
"coordinates":"37.146865, -121.656103,112m",
"time":"Sat Aug 31 00:44:13 2019 GMT"
},
"pbch":{
"peakEvm":{
"percent":13.430730819702148,
"subcarrierNumber":12,
"symbolNumber":5
},
"rmsEvm":1.7515575885772705
},
"pss":{
"peakEvm":{
"percent":13.430730819702148,
"subcarrierNumber":12,
"symbolNumber":5
},
"rmsEvm":1.7515575885772705
},
"sss":{
"peakEvm":{
"percent":13.430730819702148,
"subcarrierNumber":12,
"symbolNumber":5
},
"rmsEvm":1.7515575885772705
},
"status":{
"hardwareErrors":{
"ADCOverRange":0,
"DeviceAccess":0,
"EEPROM":0,
"IrregularData":0,
"Limit":0,
"LockLO1":0,
"LockLO2":0,
"NoCal":0,
"Overpower":0,
"SLOLock":0,
"Saturation":0,
"TgLockLo1":0
},
"statusMessage":"statusSyncSigEvmMeasDone",
"statusNumber":18
}
}
:FETCh:SYNC:POWer?
Title:
Fetch Sync Power
Description:
Returns the sync power measurements in json format. If a measurement is in progress, it blocks until complete.
{
"carrierId":1,
"gps": {
"coordinates":"37.146865, -121.656103,112m",
"time":"Sat Aug 31 00:44:13 2019 GMT"
},
"pbchPower":-48.73955825818837,
"pssPower":-48.870106550516724,
"sssPower":-48.8758737536726,
"status":{
"hardwareErrors":{
"ADCOverRange":0
},
"statusMessage":"statusSyncandBchPwrDone",
"statusNumber":12
}
}
:FETCh:TAE?
Title:
Fetch Time Alignment Error
Description:
Returns the Time Alignment Error measurements in json format.
If a measurement is in progress, it blocks until complete.
{
"TimeAlignmentErrors":[
{
"antennaPair":{
"alignmentError":2.6679842335397552e-08,"antennaNumbers":"1,2"
}},
{
"antennaPair":{
"alignmentError":-1.845241115461249e-08,"antennaNumbers":"1,3"
}},
{
"antennaPair":{
"alignmentError":-4.5132253490010044e-08,"antennaNumbers":"2,3"
}}
],
"antennaTimeOffsets":{
"antennaOne":1.6969097771379893e-07
"antennaThree":1.8814338886841142e-07,
"antennaTwo":1.4301113537840138e-07,
"antennaZero":null,
},
"carrierId":1,
"gps":{
"coordinates":"37.146865, -121.656103,112m",
"time":"Sat Aug 31 00:44:13 2019 GMT"
},
"status":{
"hardwareErrors":{
"ADCOverRange":0,
"DeviceAccess":0,
"EEPROM":0,
"IrregularData":0,
"Limit":0,
"LockLO1":0,
"LockLO2":0,
"NoCal":0,
"Overpower":0,
"SLOLock":0,
"Saturation":0,
"TgLockLo1":0
},
"statusMessage":"statusAntPortTimeAlignMeasDone",
"statusNumber":22
}
}
:FORMat[:TRACe][:DATA] <ASCII|INTeger|REAL>,[<numeric_value>]
:FORMat[:TRACe][:DATA]?
Title:
Trace Data Format
Description:
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 continuously 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.
In the case of demodulation measurements, only the *OPC? query is applicable for purposes of synchronization; the query will only return a value when both the sweep and the demodulation have completed.
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 until 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.
:INSTrument:ACTive:STATe <0 | 1 | ON | OFF>
:INSTrument:ACTive:STATe?
Title:
RemoteSpectrumAnalyzerInUse
Description:
The "set" state indicates that the instrument is used by someone.
The "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 is 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:
Only available in Spectrum Analyzer mode. ([:SENSe]:MODE SPEC)
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:
Only available in Spectrum Analyzer mode. ([:SENSe]:MODE SPEC)
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. It is a combination of the commands :CONFigure:CHPower; :READ:CHPower:CHPower?
To measure both channel power and channel power density use MEASure: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: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. It is a combination of the commands :CONFigure:CHPower; :READ:CHPower:DENSity?
To measure both channel power and channel power density use MEASure: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:DENSity?
:MEASure:IQ:CAPTure
Title:
StartIQCapture
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.
In products that support SENSe:SWEep:MODe, if the sweep mode (see SENSe:SWEep:MODe) is not currently FFT, this command will set it to FFT prior to starting the capture.
:MEASure:IQ:CAPTure:FAIL <OFF|FIRSt|REPeat>
:MEASure:IQ:CAPTure:FAIL?
Title:
Capture on Failure
Description:
Sets or queries whether the instrument will automatically save an IQ capture when losing sync.
When the instrument goes from having good sync to no sync, the IQ data for the failed measurement is saved to the user partition.
"FIRSt" causes a single capture to be performed and then transition to the OFF" state. REPeat" causes saves the IQ data on every loss of sync.
"FIRSt" is recommended to avoid accidentally filling up the user partition.
This command is only available when in 5GNR Analyzer mode ([:SENSe]:MODE NRADio).
Parameter(s):
<OFF|FIRSt|REPeat>
Query Return:
OFF|FIRS|REP
Default Value:
OFF
:MMEMory:COEvent:TIMer:INTerval <numeric_value> {PS | NS | US | MS | S | MIN | HR}
:MMEMory:COEvent:TIMer:INTerval?
Title:
IQ Capture Timer Interval
Description:
This command sets or queries the time interval between IQ captures in miliseconds.
Used for Continuous Capture mode only - does not affect Single Capture or Streaming modes.
Parameter(s):
<numeric_value> {PS | NS | US | MS | S | MIN | HR}
Query Return:
Numeric (ms)
Default Value:
0 ms
Default Unit:
ms
Range:
0 ms to 216000000 ms
: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:CATalog:MSUSs? for information on obtaining the list of available devices. MSUS parameter is case sensitive.
For example:
MMEMory:LOAD:LIMit "ALL","/example_limit_file", "USB1-1"
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.
Parameter(s):
<string>,<string>,<string>
:MMEMory:LOAD:RAM <numeric_value>,<numeric_value>,<string>
Title:
Load RAM
Description:
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>
:MMEMory:LOAD:RECord <string>,<string>
Title:
Load Playback File
Description:
This command loads a file made with Trace Recording for playback.
1. File path: The file path (including file name) relative to the MSUS root directory. File extension is optional.
2. MSUS: Device to recall the file from. See MMEMory:CATalog:MSUSs? for information on obtaining the list of available devices.
Parameter(s):
<string>,<string>
:MMEMory:LOAD:SEMask:CUSTom <string>,<string>
Title:
Load Custom SEM From File
Description:
This command loads sem mask data from the specified csv file.
The file location is resolved using the MSUS and file path parameters. Parameters:
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:CATalog:MSUSs? for information on obtaining the list of available devices. MSUS parameter is case sensitive.
For example:
MMEMory:LOAD:SEMask:CUSTom "/example_mask.csv", "USB1-1"
Parameter(s):
<string>,<string>
:MMEMory:STOEvent:CLEarall
Title:
Clear All Save On Event
Description:
Turns off all save on event types that are active.
:MMEMory:STOEvent:EOSWeep:MODE <CONTinuous|SINGle>
:MMEMory:STOEvent:EOSWeep:MODE?
Title:
End of Sweep Save On Event Mode
Description:
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}
:MMEMory:STOEvent:LIMit:INTerval?
Title:
Limit Save On Event Interval
Description:
Sets the time interval to keep saving after a limit line failure has occured when :MMEMory:STOEvent:LIMit:MODE is set to INTerval.
Parameter(s):
<numeric_value> {PS | NS | US | MS | S | MIN | HR}
Query Return:
Numeric (ms)
Default Value:
60000 ms
Default Unit:
ms
Range:
0 ms to 216000000 ms
:MMEMory:STOEvent:LIMit:MODE <CONTinuous|SINGle|INTerval>
:MMEMory:STOEvent:LIMit:MODE?
Title:
End of Sweep Save On Event Mode
Description:
Specifies the stop mode of the limit 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}
:MMEMory:STOEvent:TIMer:INTerval?
Title:
Timer Save On Event Interval
Description:
Sets the time interval to save when :MMEMory:STOEvent:TIMer[:STATe] is enabled. The queried value is always in milliseconds.
Parameter(s):
<numeric_value> {PS | NS | US | MS | S | MIN | HR}
Query Return:
Numeric (ms)
Default Value:
240000 ms
Default Unit:
ms
Range:
0 ms to 3600000 ms
: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:CAPTure
Title:
Save IQ Capture
Description:
This command performs saving the IQ Capture data to file.
:MMEMory:STORe:CAPTure:MODE <AUTomatic|MANual>
:MMEMory:STORe:CAPTure:MODE?
Title:
IQ Capture Saving Mode
Description:
This command sets or queries the saving mode for IQ Capture.
AUTomatic saves every capture to file.
MANual saves the latest capture to file when user send :MMEMory:STORe:CAPTure command.
Parameter(s):
<AUTomatic|MANual>
Query Return:
AUT|MAN
Default Value:
AUTomatic
:MMEMory:STORe:CAPTure:MSUS <string>
:MMEMory:STORe:CAPTure:MSUS?
Title:
IQ Storage Device
Description:
This command sets or queries the storage device on which to store IQ capture files. Use the :MMEMory:CATalog:MSUSs? query to retrieve a list of valid parameters for this setting.
Parameter(s):
<string>
Default Value:
Internal
:MMEMory:STORe:CAPTure:PATH <string>
:MMEMory:STORe:CAPTure:PATH?
Title:
IQ File Location
Description:
This command sets or queries the relative path to the directory in which IQ capture files will be saved. The path is relative to the selected IQ storage device specified by the IQ Storage Device setting (MMEM:STOR:CAPT:MSUS).
Parameter(s):
<string>
Default Value:
Captures
:MMEMory:STORe:CAPTure:PREFix <string>
:MMEMory:STORe:CAPTure:PREFix?
Title:
IQ File Name Prefix
Description:
This command sets or queries the file name prefix for IQ Capture or IQ Streaming.
Parameter(s):
<string>
Default Value:
Capture
: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:CATalog:MSUSs? for information on obtaining the list of available devices. MSUS parameter is case sensitive.
For example:
MMEMory:STORe:LIMit "ALL","/example_limit_file", "USB1-1"
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):
<string>,<string>,<string>
:MMEMory:STORe:RAM <numeric_value>,<numeric_value>,<string>
Title:
Store RAM
Description:
Load data from RAM to a file. This command takes three parameters
1. data block size: that needs to be loaded in bytes (must be a word aligned)
2. offset: in bytes from start of RAM address to load from
3. filename: name of the file without the full path. This is the destination file where the contents of RAM are copied over
Parameter(s):
<numeric_value>,<numeric_value>,<string>
:MMEMory:STORe:RECord:CSV:DISCard
Title:
Discard Trace Recording CSV File
Description:
This command discards the last file written for Trace Recording in CSV.
:MMEMory:STORe:RECord:CSV:MSUS <string>
:MMEMory:STORe:RECord:CSV:MSUS?
Title:
Trace Recording CSV Storage Device
Description:
This command sets or queries the MSUS device that Trace Recordings in CSV will be stored in.
Parameter(s):
<string>
Default Value:
Internal
:MMEMory:STORe:RECord:CSV:PATH <string>
:MMEMory:STORe:RECord:CSV:PATH?
Title:
Trace Recording CSV Storage Location
Description:
This command sets or queries the directory that Trace Recordings in CSV will be stored in.
Parameter(s):
<string>
Default Value:
PlaybackCsv
:MMEMory:STORe:RECord:CSV:PREFix <string>
:MMEMory:STORe:RECord:CSV:PREFix?
Title:
Trace Recording CSV File Name Prefix
Description:
This command sets or queries the file name prefix for Trace Recording in CSV.
Parameter(s):
<string>
Default Value:
Traces
:MMEMory:STORe:RECord:MSUS <string>
:MMEMory:STORe:RECord:MSUS?
Title:
Trace Recording Storage Device
Description:
This command sets or queries the MSUS device recorded traces will be stored in.
Parameter(s):
<string>
Default Value:
Internal
:MMEMory:STORe:RECord:PATH <string>
:MMEMory:STORe:RECord:PATH?
Title:
Trace Recording Storage Location
Description:
This command sets or queries the path to the directory recorded traces will be stored in.
Parameter(s):
<string>
Default Value:
Playback
:MMEMory:STORe:RECord:PREFix <string>
:MMEMory:STORe:RECord:PREFix?
Title:
Trace Recording File Name Prefix
Description:
This command sets or queries the file name prefix for Trace Recording.
Parameter(s):
<string>
Default Value:
RecordedSession
:MMEMory:STORe:STREam:MSUS <string>
:MMEMory:STORe:STREam:MSUS?
Title:
IQ Stream USB Storage
Description:
This command sets or queries the USB storage device on which to store IQ stream files. Use the :MMEMory:CATalog:MSUSs? query to retrieve a list of valid USB device for this setting.
Parameter(s):
<string>
Default Value:
None
:MMEMory:STORe:STREam:PATH <string>
:MMEMory:STORe:STREam:PATH?
Title:
IQ Stream File Location
Description:
This command sets or queries the relative path to the directory in which IQ stream files will be saved. The path is relative to the USB storage device specified by the IQ Stream USB Storage setting (MMEM:STOR:STRE:MSUS).
Parameter(s):
<string>
Default Value:
Streams
:MMEMory:STORe:TRACe:CSV <string>,<string>,<string>
Title:
Store Trace in CSV
Description:
This command saves the current trace to CSV file in specified file location. The file location is resolved using the MSUS and file path parameters. These parameters are case sensitive.
Parameters:
1. Label: Used to specify which trace to save. Currently, the label only supports saving all traces. Send an empty string or "ALL" to store all traces.
2. File path: The file path (including file name) relative to the MSUS root directory. File extension should not be specified.
3. MSUS: Device to save the file on. See MMEMory:CATalog:MSUSs? for information on obtaining the list of available devices.
A common cause of the command failure is not having enough space available on MSUS to save trace. Use :MMEMory:CATalog:DIRectory query command to retrieve the total space available on MSUS.
Parameter(s):
<string>,<string>,<string>
:OUTPut:IF:FILTer <K750|M7P5|M14|M30|M100>
:OUTPut:IF:FILTer?
Title:
IF Filter Select
Description:
If the following criteria is met the IF filter can be manually selected: Option 0089 (IF Output) is enabled/Zero Span is selected/IF output is ON. Parameter Filter Bandwidth
K750 750kHz
M7P5 7.5MHz
M14 14MHz
M30 32MHz
M100 100MHz
**The 100MHz filter selection is only available with options 0103 and 0104
Parameter(s):
<K750|M7P5|M14|M30|M100>
Query Return:
K750|M7P5|M14|M30|M100
Default Value:
M100
: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
:OUTPut:ROSCillator:STATe <0 | 1 | ON | OFF>
:OUTPut:ROSCillator:STATe?
Title:
10MHz Reference Output State
Description:
This command enables or disables the 10MHz reference output. The query returns 1 if 10MHz reference output is enabled; otherwise, returns 0.
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 the equivalent of the command sequence :ABORT; :INITiate; :FETCh:ACPower?
The channel power measurement must be the active measurement (specified by the command :CONFigure:ACPower).The instrument should be in the single sweep mode.
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 or if :INITiate:CONTinuous is set to ON(continuous sweep) 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 the equivalent of the command sequence: ":ABORT; :INITiate; :FETCh:CHPower?"
The channel power measurement must be the active measurement (specified by the command :CONFigure:CHPower).The instrument should be in the single sweep mode. Data is returned as 2 comma-separated 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, or if :INITiate:CONTinuous is set to ON(continuous sweep), it returns a string "nan,nan".
:READ:CHPower:CHPower?
Title:
Read Channel Power
Description:
Triggers a new channel power measurement and returns the channel power result: channel power. It is the equivalent of the command sequence ":ABORT; :INITiate; :FETCh:CHPower:CHPower?"
The channel power measurement must be the active measurement (specified by the command :CONFigure:CHPower).The instrument should be in the single sweep mode. Data returned is: channel power.
If the measurement is not active, the instrument will indicate error -400 and return the string "nan,nan". If :INITiate command fails, or if :INITiate:CONTinuous is set to ON(continuous sweep), it returns a string "nan,nan".
:READ:CHPower:DENSity?
Title:
Read Channel Power Density
Description:
Triggers a new channel power measurement and returns the results: channel power density. It is the equivalent of the command sequence :ABORT; :INITiate; :FETCh:CHPower:DENSity? The channel power measurement must be the active measurement (specified by the command :CONFigure:CHPower).The instrument should be in the single sweep mode. Data returned is: 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, or if :INITiate:CONTinuous is set to ON(continuous sweep), it returns a string "nan,nan"
:READ:EIRPower?
Title:
Read EIRP
Description:
Triggers a new EIRP measurement and returns the current EIRP, Max EIRP, Horizontal EIRP, Vertical and Sum EIRP results in dBm. It is a combination of the commands :ABORT; :INITiate; :FETCh:EIRPower?
The EIRP measurement must be the active measurement (specified by the command :CONFigure:EIRPower). The instrument should be in the single sweep mode. Data is returned as 2 comma-separated values: EIRP, max EIRP. If the measurement is not active, the instrument will indicate error -400 and return the string "nan,nan". If :INITiate command fails or if :INITiate:CONTinuous is set to ON(continuous sweep), it returns a string "nan,nan".
:READ:EIRPower:DATA?
Title:
Read Current EIRP
Description:
Triggers a new EIRP measurement and returns the current EIRP result in dBm. It is a combination of the commands :ABORT; :INITiate; :FETCh:EIRPower:DATA?
The EIRP measurement must be the active measurement (specified by the command :CONFigure:EIRPower).The instrument should be in the single sweep mode. If the measurement is not active, the instrument will indicate error -400 and return the string "nan". If :INITiate command fails or if :INITiate:CONTinuous is set to ON(continuous sweep),it returns a string "nan".
:READ:EIRPower:MAXimum?
Title:
Read MAXimum EIRP
Description:
Triggers a new EIRP measurement and returns the maximum EIRP results in dBm. It is a combination of the commands :ABORT; :INITiate; :FETCh:EIRPower:MAX?
The EIRP measurement must be the active measurement (specified by the command :CONFigure:EIRPower). The instrument should be in the single sweep mode. If the measurement is not active, the instrument will indicate error -400 and return the string "nan". If :INITiate command fails or if :INITiate:CONTinuous is set to ON(continuous sweep),it returns a string "nan".
:READ:SEMask?
Title:
Read Spectral Emission Mask
Description:
Triggers a new Spectral Emission Mask measurement and returns the current Spectral Emission Mask mesurement result. It is a combination of the commands :ABORT; :INITiate; :FETCh:SEMask? The Spectracl Emission Mask measurement must be the active measurement (specified by the command :CONFigure:SEMask). Data is returned as ASCII of JSON object. Please refer to :FETCh:SEMask command for sample response.
If the measurement is not active, the instrument will indicate error -400 and return an empty object.
[:SENSe]:ACPower:BANDwidth|BWIDth:ADJacent <numeric_value> {HZ | KHZ | MHZ | GHZ}
[:SENSe]:ACPower:BANDwidth|BWIDth:ADJacent?
Title:
Adjacent CHPWR Adjacent Integration Bandwidth
Description:
Sets the adjacent channel bandwidth for adjacent channel power measurement. Integration bandwidth must be less than or equal to span
Parameter(s):
<numeric_value> {HZ | KHZ | MHZ | GHZ}
Query Return:
Numeric (Hz)
Default Value:
10350000 Hz
Default Unit:
Hz
Range:
10 Hz to 400000000000 Hz
[:SENSe]:ACPower:BANDwidth|BWIDth:ALTernate <numeric_value> {HZ | KHZ | MHZ | GHZ}
[:SENSe]:ACPower:BANDwidth|BWIDth:ALTernate?
Title:
Adjacent CHPWR Alternate Integration Bandwidth
Description:
Sets the alternate channel bandwidth for adjacent channel power measurement. Integration bandwidth must be less than or equal to span
Parameter(s):
<numeric_value> {HZ | KHZ | MHZ | GHZ}
Query Return:
Numeric (Hz)
Default Value:
10350000 Hz
Default Unit:
Hz
Range:
10 Hz to 400000000000 Hz
[:SENSe]:ACPower:BANDwidth|BWIDth:MAIN <numeric_value> {HZ | KHZ | MHZ | GHZ}
[:SENSe]:ACPower:BANDwidth|BWIDth:MAIN?
Title:
Adjacent CHPWR Main Integration Bandwidth
Description:
Sets the main channel bandwidth for adjacent channel power measurement. Integration bandwidth must be less than or equal to span
Parameter(s):
<numeric_value> {HZ | KHZ | MHZ | GHZ}
Query Return:
Numeric (Hz)
Default Value:
10350000 Hz
Default Unit:
Hz
Range:
10 Hz to 400000000000 Hz
[:SENSe]:ACPower:BANDwidth|BWIDth:SPACing <numeric_value> {HZ | KHZ | MHZ | GHZ}
[:SENSe]:ACPower:BANDwidth|BWIDth:SPACing?
Title:
Adjacent Channel Power Spacing
Description:
Controls the channel spacing which is the distance from the modulated carrier signal to the
upper or lower Adjacent Channel.
Parameter(s):
<numeric_value> {HZ | KHZ | MHZ | GHZ}
Query Return:
Numeric (Hz)
Default Value:
10350000 Hz
Default Unit:
Hz
Range:
10 Hz to 400000000000 Hz
[:SENSe]:ACPower:STATe <0 | 1 | ON | OFF>
[:SENSe]:ACPower:STATe?
Title:
Adjacent Channel Power State
Description:
Sets the state of the adjacent channel power ratio measurement, ON or OFF. When using :CONFigure:ACPower, the state is automatically set to ON
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
[:SENSe]:ARFChannel <numeric_value>
[:SENSe]:ARFChannel?
Title:
Absolute RF Channel Number
Description:
Sets or queries the Absolute RF Channel Number for the current demod measurement. Accepted values vary based on the current operating band. Inputting invalid values will set the closest valid value possible for the given circumstances.
When the operating band is not being used ([:SENSe]:OBANd is INValid), this value will not be settable. Attempts to set this when the system is in this state will return the error -221.
Parameter(s):
<numeric_value>
Query Return:
Numeric
Default Value:
0
Range:
0 to 3279165
[:SENSe]:AVERage:COUNt <numeric_value>
[:SENSe]:AVERage:COUNt?
Title:
Sense Average Count
Description:
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.
Parameter(s):
<numeric_value>
Query Return:
Numeric
Default Value:
10
Range:
2 to 1000
[:SENSe]:AVERage:TYPE <NORMal|MINimum|MAXimum|AVERage|RMAXimum|RMINimum|RAVerage>
[:SENSe]:AVERage:TYPE?
Title:
Sense Average Type
Description:
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.
Parameter(s):
<NORMal|MINimum|MAXimum|AVERage|RMAXimum|RMINimum|RAVerage>
Query Return:
NORM|MIN|MAX|AVER|RMAX|RMIN|RAV
Default Value:
NORMal
[:SENSe]:BANDwidth|BWIDth[:RESolution] <numeric_value> {HZ | KHZ | MHZ | GHZ}
[:SENSe]:BANDwidth|BWIDth[:RESolution]?
Title:
RBW
Description:
Sets the resolution bandwidth.
Note that using this command turns the automatic resolution bandwidth setting OFF.
Parameter(s):
<numeric_value> {HZ | KHZ | MHZ | GHZ}
Query Return:
Numeric (Hz)
Default Value:
3000000 Hz
Default Unit:
Hz
Range:
1 Hz to 50000000 Hz
[:SENSe]:BANDwidth|BWIDth[:RESolution] <numeric_value> {HZ | KHZ | MHZ | GHZ}
[:SENSe]:BANDwidth|BWIDth[:RESolution]?
Title:
RBW Zero Span
Description:
Sets the resolution bandwidth.
Note that using this command turns the automatic resolution bandwidth setting OFF. In Zero Span, the range will change to allow a mininum of 5 KHz to the maximum of 20 MHz.
Parameter(s):
<numeric_value> {HZ | KHZ | MHZ | GHZ}
Query Return:
Numeric (Hz)
Default Value:
3000000 Hz
Default Unit:
Hz
Range:
5000 Hz to 20000000 Hz
[:SENSe]:BANDwidth|BWIDth[:RESolution]:RATio <numeric_value>
[:SENSe]:BANDwidth|BWIDth[:RESolution]:RATio?
Title:
RBW Span Ratio
Description:
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.
Parameter(s):
<numeric_value>
Query Return:
Numeric
Default Value:
0.01
Range:
1e-05 to 1
[:SENSe]:BANDwidth|BWIDth:VIDeo <numeric_value> {HZ | KHZ | MHZ | GHZ}
[:SENSe]:BANDwidth|BWIDth:VIDeo?
Title:
VBW
Description:
Sets the video bandwidth.
Note that using this command turns the automatic video bandwidth setting OFF.
Parameter(s):
<numeric_value> {HZ | KHZ | MHZ | GHZ}
Query Return:
Numeric (Hz)
Default Value:
1000000 Hz
Default Unit:
Hz
Range:
1 Hz to 50000000 Hz
[:SENSe]:BANDwidth|BWIDth:VIDeo <numeric_value> {HZ | KHZ | MHZ | GHZ}
[:SENSe]:BANDwidth|BWIDth:VIDeo?
Title:
VBW Zero Span
Description:
Sets the video bandwidth.
Note that using this command turns the automatic video bandwidth setting OFF. In Zero Span, the range will change to allow a mininum of 5 KHz to the maximum of 20 MHz.
The Default value will also change to 3 MHz.
Parameter(s):
<numeric_value> {HZ | KHZ | MHZ | GHZ}
Query Return:
Numeric (Hz)
Default Value:
3000000 Hz
Default Unit:
Hz
Range:
5000 Hz to 20000000 Hz
[:SENSe]:BANDwidth|BWIDth:VIDeo:RATio <numeric_value>
[:SENSe]:BANDwidth|BWIDth:VIDeo:RATio?
Title:
VBW RBW Ratio
Description:
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
Parameter(s):
<numeric_value>
Query Return:
Numeric
Default Value:
0.333333333333333
Range:
1e-05 to 1
[:SENSe]:BANDwidth|BWIDth:VIDeo:TYPE <LINear|LOGarithmic>
[:SENSe]:BANDwidth|BWIDth:VIDeo:TYPE?
Title:
VBW Averaging
Description:
Changes the VBW/Average type.
Parameter(s):
<LINear|LOGarithmic>
Query Return:
LIN|LOG
Default Value:
LINear
[: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 decoupled 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 decoupled 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]:BEAM <numeric_value>
[:SENSe]:BEAM?
Title:
Measured Beam
Description:
Sets or queries the beam number to measure and display.
Parameter(s):
<numeric_value>
Query Return:
Numeric
Default Value:
0
Range:
0 to 63
[:SENSe]:BEAM:TRACking:STATe <0 | 1 | ON | OFF>
[:SENSe]:BEAM:TRACking:STATe?
Title:
Detected Beam Tracking State
Description:
Sets or queries the state of the beam tracking functionality.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
[:SENSe]:CAGGregation?
Title:
Get Carrier Aggregation Measurements
Description:
Returns the Carrier Aggregation measurements for each carrier in a JSON format. Unlike [:SENSe]:FETCh:CAGGregation this command does not wait for the current measurement to complete before returning results.
[:SENSe]:CAGGregation:CARRier:ACTive <numeric_value>
[:SENSe]:CAGGregation:CARRier:ACTive?
Title:
Active Carrier
Description:
Sets and queries the active carrier in the Carrier Aggregation measurement.
Parameter(s):
<numeric_value>
Query Return:
Numeric
Default Value:
1
Range:
1 to 8
[:SENSe]:CAGGregation:CARRier:COUNt <numeric_value>
[:SENSe]:CAGGregation:CARRier:COUNt?
Title:
Number Of Carriers
Description:
Sets and queries the number of carriers in the Carrier Aggregation measurement.
Parameter(s):
<numeric_value>
Query Return:
Numeric
Default Value:
2
Range:
1 to 8
[:SENSe]:CAGGregation:STATe <0 | 1 | ON | OFF>
[:SENSe]:CAGGregation:STATe?
Title:
Carrier Aggregation Measurement State
Description:
Turns on Carrier Aggregation, disables other measurements. When Carrier Aggregation measurement is on, changing frequencies, band, and antenna configurations will only apply to the active carrier. For instance, if the active carrier is set to 2, changing the center frequency will only change the center frequency for the carrier 2. Use command [:SENSe]:CAGGregation:CARRier:ACTive to set the active carrier.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
[:SENSe]:CBWidth <numeric_value> {HZ | KHZ | MHZ | GHZ}
[:SENSe]:CBWidth?
Title:
Channel Bandwidth
Description:
Sets or queries the channel bandwidth for the current demod measurement.
Full set of possible values are 5, 10, 15, 20, 25, 30, 40, 50, 60, 70, 80, 90, 100 MHz, though actual accepted values vary based on the current operating band and purchased options.
Parameter(s):
<numeric_value> {HZ | KHZ | MHZ | GHZ}
Query Return:
Numeric (Hz)
Default Value:
100000000 Hz
Default Unit:
Hz
Range:
5000000 Hz to 400000000 Hz
[:SENSe]:CBWidth <numeric_value> {HZ | KHZ | MHZ | GHZ}
[:SENSe]:CBWidth?
Title:
Channel Bandwidth
Description:
Sets or queries the channel bandwidth for the current demod measurement.
Full set of possible values are 1.4, 3, 5, 10, 15, 20MHz.
Parameter(s):
<numeric_value> {HZ | KHZ | MHZ | GHZ}
Query Return:
Numeric (Hz)
Default Value:
100000000 Hz
Default Unit:
Hz
Range:
5000000 Hz to 400000000 Hz
[:SENSe]:CBWidth:CATalog?
Title:
Channel Bandwidth Catalog
Description:
Queries a list of all valid channel bandwidth values based on current settings.
Data is returned in a comma-separated list of frequencies in Hz, e.g. "5000000,10000000"
[:SENSe]:CCHannel:STATe <0 | 1 | ON | OFF>
[:SENSe]:CCHannel:STATe?
Title:
Control Channel Measurement State Command
Description:
Turns on control channel measurement, disables other measurements
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
[:SENSe]:CHANnel:SCSPacing:CATalog?
Title:
Channel Subcarrier Spacing Catalog
Description:
Queries a list of all valid channel subcarrier spacing values based on current settings.
Data is returned in a comma-separated list of frequencies in Hz, e.g. "15000,30000,60000"
Default Value:
15000,30000,120000
[:SENSe]:CHPower:BANDwidth|BWIDth:INTegration <numeric_value> {HZ | KHZ | MHZ | GHZ}
[:SENSe]:CHPower:BANDwidth|BWIDth:INTegration?
Title:
CHPWR Integration Bandwidth
Description:
Sets the integration bandwidth for channel power measurement. Integration bandwidth must be less than or equal to span
Parameter(s):
<numeric_value> {HZ | KHZ | MHZ | GHZ}
Query Return:
Numeric (Hz)
Default Value:
10350000 Hz
Default Unit:
Hz
Range:
10 Hz to 400000000000 Hz
[:SENSe]:CHPower:STATe <0 | 1 | ON | OFF>
[:SENSe]:CHPower:STATe?
Title:
Channel Power State
Description:
Sets the state of the channel power measurement, ON or OFF. When
using :CONFigure:CHPower,the state is automatically set to ON
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
[:SENSe]:CONStellation <PBCH|PDSCh>
[:SENSe]:CONStellation?
Title:
Constellation Select
Description:
Sets or queries the constellation data selection for the current LTE or 5G measurement. Only PBCH is available in 5G measurement.
Valid selections are: PBCH and PDSCH.
Parameter(s):
<PBCH|PDSCh>
Query Return:
PBCH|PDSC
Default Value:
PDSCh
[:SENSe]:CONStellation:PBCH?
Title:
PBCH Constellation
Description:
Get the Physical Broadcast Channel (PBCH) constellation results immediately from the last complete measurement. See the description for :FETCh:CONStellation:PBCH for the results format.
[:SENSe]:CONStellation:PBCH:BEAM <numeric_value>
[:SENSe]:CONStellation:PBCH:BEAM?
Title:
Constellation Measurement State
Description:
Sets the beam number to filter for in the PBCH constellation measurement.
Parameter(s):
<numeric_value>
Query Return:
Numeric
Default Value:
0
Range:
0 to 63
[:SENSe]:CONStellation:PDSCh?
Title:
Data Channel Constellation
Description:
Get the Physical Downlink Shared Channel (PDSCH) constellation results immediately from the last complete measurement. See the description for :FETCh:CONStellation:PDSCh for the results format.
[:SENSe]:CONStellation:REFerence:STATe <0 | 1 | ON | OFF>
[:SENSe]:CONStellation:REFerence:STATe?
Title:
Constellation Reference Point State
Description:
Turns on/off constellation reference points
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
[:SENSe]:CONStellation:STATe <0 | 1 | ON | OFF>
[:SENSe]:CONStellation:STATe?
Title:
Constellation Measurement State
Description:
Turns on/off constellation measurement, disables other measurements
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
[:SENSe]:CYCLicprefix <NORMal|EXTended|AUTO>
[:SENSe]:CYCLicprefix?
Title:
Cyclic Prefix
Description:
Sets or queries the cyclic prefix type.
Available parameters are NORMal, EXTended, and AUTO for LTE mode.
Parameter(s):
<NORMal|EXTended|AUTO>
Query Return:
NORM|EXT|AUTO
Default Value:
AUTO
[:SENSe]:CYCLicprefix <NORMal|EXTended|AUTO>
[:SENSe]:CYCLicprefix?
Title:
Cyclic Prefix
Description:
Sets or queries the cyclic prefix type. Only NORMal is available in 5GNR
Parameter(s):
<NORMal|EXTended|AUTO>
Query Return:
NORM|EXT|AUTO
Default Value:
AUTO
[:SENSe]:DETector[:FUNCtion] <POSitive|RMS|NEGative|SAMPle>
[:SENSe]:DETector[:FUNCtion]?
Title:
Detection Mode
Description:
Sets the detection method for calculating each display point. This command changes the detection method for the currently selected trace (see Select Trace command). To set the detection mode for any trace use the Trace Detector Type command. 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 measurement. NEGative Peak detection displays the minimum value of the associated measurements. SAMPle detection selects one of the associated measurement points to display. In zero span and RTSA mode the SAMPle detection replaces RMS detection.
Parameter(s):
<POSitive|RMS|NEGative|SAMPle>
[[:SENSe]:DUPLex <FDD|TDD>
[:SENSe]:DUPLex?
Title:
Duplex Type
Description:
Sets or queries the duplex type. TDD is available for 5GNR and LTE. FDD is availiable for LTE.
Parameter(s):
<FDD|TDD>
Query Return:
FDD|TDD
Default Value:
TDD
[:SENSe]:EARFchannel <numeric_value>
[:SENSe]:EARFchannel?
Title:
E-UTRA Absolute RF Channel Number
Description:
Sets or queries the E-UTRA Absolute RF Channel Number for the current demod measurement. Accepted values vary based on the current operating band. Inputting invalid values will set the closest valid value possible for the given circumstances.
When the operating band is not being used ([:SENSe]:OBANd is INValid), this value will not be settable. Attempts to set this when the system is in this state will return the error -221.
Parameter(s):
<numeric_value>
Query Return:
Numeric
Default Value:
0
Range:
0 to 3279165
[:SENSe]:EIRPower:CLOSs <numeric_value> {DB}
[:SENSe]:EIRPower:CLOSs?
Title:
EIRP Test Port Cable Loss
Description:
This command sets or queries the test port cable loss for EIRP measurement.
See UNIT:POWer to query or set the current amplitude units.
Parameter(s):
<numeric_value> {DB}
Query Return:
Numeric (dB)
Default Value:
0 dB
Default Unit:
dB
Range:
0 dB to 999 dB
[:SENSe]:EIRPower:DISTance <numeric_value>
[:SENSe]:EIRPower:DISTance?
Title:
EIRP Measurement's Distance
Description:
This command sets or queries the EIRP measurement's distance. Allowed unit types include m (meters) or ft (feet).
Note that if no unit is passed in, the instrument will assume that the incoming or outgoing unit is the unit type set through the [:SENSe]:EIRPower:DISTance:UNIT SCPI command.
Parameter(s):
<numeric_value>
Default Value:
100 m
Default Unit:
m
Range:
1 m to 1000 m
[:SENSe]:EIRPower:DISTance:UNIT <METers|FEET>
[:SENSe]:EIRPower:DISTance:UNIT?
Title:
EIRP Distance Units
Description:
This command sets or queries the EIRP distance units. The query returns:
MET - Meters
FEET - Feet
Parameter(s):
<METers|FEET>
Query Return:
MET|FEET
Default Value:
METers
[:SENSe]:EIRPower:MAXimum:COUNt?
Title:
Maximum EIRP Count
Description:
This command returns the current maximum EIRP count.
[:SENSe]:EIRPower:MAXimum:RESet
Title:
Reset Maximum EIRP Count
Description:
This command resets the maximum EIRP count.
[:SENSe]:EIRPower:PLOSs?
Title:
EIRP Path Loss
Description:
This command queries the EIRP total path loss between the base station gNB and test antenna.
Query Return:
Numeric (dB)
Default Value:
0 dB
Default Unit:
dB
Range:
0 dB to 999 dB
[:SENSe]:EIRPower:RAGain <numeric_value> {DB}
[:SENSe]:EIRPower:RAGain?
Title:
EIRP Rx Antenna Gain
Description:
This command sets or queries the EIRP Rx Antenna Gain in dBi.
See UNIT:POWer to query or set the current amplitude units.
Parameter(s):
<numeric_value> {DB}
Query Return:
Numeric (dB)
Default Value:
0 dB
Default Unit:
dB
Range:
0 dB to 999 dB
[:SENSe]:EIRPower:STATe <0 | 1 | ON | OFF>
[:SENSe]:EIRPower:STATe?
Title:
EIRP State
Description:
Sets the state of the EIRP measurement, ON or OFF. When using :CONFigure:EIRPower,the state is automatically set to ON
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
[:SENSe]:EIRPower:SUM:RESet
Title:
EIRP Sum Reset
Description:
Resets the Horizontal and Vertical EIRP values.
[:SENSe]:EIRPower:TAGain <numeric_value> {DB}
[:SENSe]:EIRPower:TAGain?
Title:
EIRP Tx Antenna Gain
Description:
This command sets or queries the EIRP Tx Antenna Gain in dBi.
See UNIT:POWer to query or set the current amplitude units.
Parameter(s):
<numeric_value> {DB}
Query Return:
Numeric (dB)
Default Value:
0 dB
Default Unit:
dB
Range:
0 dB to 999 dB
[:SENSe]:FPAView <FRAMe|SUBFrame|SLOT>
[:SENSe]:FPAView?
Title:
Frame Power Analysis View
Description:
Sets or queries the Frame Power Analysis view mode for the current LTE measurement.
Valid selections are: FRAME, SUBFRAME or SLOT.
Parameter(s):
<FRAMe|SUBFrame|SLOT>
Query Return:
FRAM|SUBF|SLOT
Default Value:
FRAMe
[:SENSe]:FRAMe:POWer:STATe <0 | 1 | ON | OFF>
[:SENSe]:FRAMe:POWer:STATe?
Title:
Frame Power Analysis State Command
Description:
Turns on frame power analysis measurement, disables other measurements
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
[:SENSe]:FREQuency:CENTer <numeric_value> {HZ | KHZ | MHZ | GHZ}
[:SENSe]:FREQuency:CENTer?
Title:
Center Frequency
Description:
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.
Parameter(s):
<numeric_value> {HZ | KHZ | MHZ | GHZ}
Query Return:
Numeric (Hz)
Default Value:
3000000000 Hz
Default Unit:
Hz
Range:
-99999999995 Hz to 299999999995 Hz
[:SENSe]:FREQuency:OFFSet <numeric_value> {HZ | KHZ | MHZ | GHZ}
[:SENSe]:FREQuency:OFFSet?
Title:
Frequency Offset
Description:
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.
Parameter(s):
<numeric_value> {HZ | KHZ | MHZ | GHZ}
Query Return:
Numeric (Hz)
Default Value:
0 Hz
Default Unit:
Hz
Range:
-10000000000 Hz to 10000000000 Hz
[:SENSe]:FREQuency:SPAN <numeric_value> {HZ | KHZ | MHZ | GHZ}
[:SENSe]:FREQuency:SPAN?
Title:
Span
Description:
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.
Note that this command is not available for Spectral Emission Mask measurement.
Parameter(s):
<numeric_value> {HZ | KHZ | MHZ | GHZ}
Query Return:
Numeric (Hz)
Default Value:
400000000000 Hz
Default Unit:
Hz
Range:
10 Hz to 400000000000 Hz
[:SENSe]:FREQuency:SPAN:FULL
Title:
Set to Full Span
Description:
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.
[:SENSe]:FREQuency:STARt <numeric_value> {HZ | KHZ | MHZ | GHZ}
[:SENSe]:FREQuency:STARt?
Title:
Start Frequency
Description:
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.
Note that this command is not available for Spectral Emission Mask measurement.
Parameter(s):
<numeric_value> {HZ | KHZ | MHZ | GHZ}
Query Return:
Numeric (Hz)
Default Value:
0 Hz
Default Unit:
Hz
Range:
-100000000000 Hz to 299999999990 Hz
[:SENSe]:FREQuency:STEP[:INCRement] <numeric_value> {HZ | KHZ | MHZ | GHZ}
[:SENSe]:FREQuency:STEP[:INCRement]?
Title:
Frequency Step
Description:
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.
Parameter(s):
<numeric_value> {HZ | KHZ | MHZ | GHZ}
Query Return:
Numeric (Hz)
Default Value:
1000000 Hz
Default Unit:
Hz
Range:
0.1 Hz to 1000000000 Hz
[:SENSe]:FREQuency:STOP <numeric_value> {HZ | KHZ | MHZ | GHZ}
[:SENSe]:FREQuency:STOP?
Title:
Stop Frequency
Description:
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.
Note that this command is not available for Spectral Emission Mask measurement.
Parameter(s):
<numeric_value> {HZ | KHZ | MHZ | GHZ}
Query Return:
Numeric (Hz)
Default Value:
6000000000 Hz
Default Unit:
Hz
Range:
-99999999990 Hz to 300000000000 Hz
[:SENSe]:FSTRength:ANTenna <string>
[:SENSe]:FSTRength:ANTenna?
Title:
Field Strength Antenna
Description:
Select or query the current antenna set for Field Strength.
Parameter(s):
<string>
Default Value:
None
[:SENSe]:FSTRength:ANTenna:FACTor?
Title:
Field Strength Antenna Factor
Description:
Returns an interpolated list of antenna factors as a json array where the size of the array corresponds to the number of display points currently selected.
For example: [ 2.0, 3.4, 5.3 ]
[:SENSe]:FSTRength:ANTenna:FILE <block data>
[:SENSe]:FSTRength:ANTenna:FILE?
Title:
User Antenna List File Import and Export
Description:
This command imports/exports a file to/from the instrument. Data is transferred to/from the instrument as an IEEE definite length arbitrary block response, which has the form <header><block>.
Block Data: The data to be written to the instrument in block data format
Please note that the maximum file transfer size to the instrument is 25 MB.
The ASCII header specifies the number of data bytes of the file. 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 file is returned in block data format with an ASCII header The query command will return a #10 if the file cannot be found.
Parameter(s):
<block data>
[:SENSe]:FSTRength:ANTenna:LIST?
Title:
Field Strength Antenna List
Description:
Returns the list of available antennas. Return value is json array containing the Antenna name, its Start Frequency and its Stop Frequency.
For example:
[{
"name": "Anritsu_Antenna_1",
"startFreq":1710000000,
"stopFreq":1880000000
},
{
"name": "Anritsu_Antenna_2",
"startFreq":1850000000,
"stopFreq":1990000000
}]
[:SENSe]:FSTRength:ANTenna:LIST:USER?
Title:
Field Strength User Antenna List
Description:
Returns the list of available user antennas. Return value is json array containing the Antenna name, its Start Frequency and its Stop Frequency.
For example:
[{
"name": "User_Antenna_1",
"startFreq":1950000000,
"stopFreq":2500000000
},
{
"name": "User_Antenna_2",
"startFreq":1650000000,
"stopFreq":1850000000
}]
[:SENSe]:FSTRength:STATe <0 | 1 | ON | OFF>
[:SENSe]:FSTRength:STATe?
Title:
Field Strength State
Description:
Sets the state of the field strength measurement ON or OFF.
If this command is set to ON, the amplitude measurement units on the instrument will be converted to its Field Strength value.
To query the amplitude measurement units, use the :UNIT:POWer? query command.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
[:SENSe]:GATE:DELay <numeric_value> {PS | NS | US | MS | S | MIN | HR}
[:SENSe]:GATE:DELay?
Title:
Gate Delay
Description:
Sets or queries the gate delay time. Available values are limited based on current mode.
Parameter(s):
<numeric_value> {PS | NS | US | MS | S | MIN | HR}
Query Return:
Numeric (ms)
Default Value:
0 ms
Default Unit:
ms
Range:
0 ms to 199.999 ms
[:SENSe]:GATE:LENGth <numeric_value> {PS | NS | US | MS | S | MIN | HR}
[:SENSe]:GATE:LENGth?
Title:
Gate Delay Length
Description:
Sets or queries the length of the gate delay. Avalailable values are limited based on current mode.
Parameter(s):
<numeric_value> {PS | NS | US | MS | S | MIN | HR}
Query Return:
Numeric (ms)
Default Value:
1 ms
Default Unit:
ms
Range:
0.001 ms to 200 ms
[:SENSe]:GATE:PERiod <P1s|P20ms|P10ms>
[:SENSe]:GATE:PERiod?
Title:
Gated Sweep Period Length
Description:
Sets or queries the time period used for the Gated Sweep functionality. Available settings are: "P10ms" (10ms) and "P20ms" (20ms).
Parameter(s):
<P1s|P20ms|P10ms>
Query Return:
P1|P20|P10
Default Value:
P20ms
[:SENSe]:GATE:STATe <0 | 1 | ON | OFF>
[:SENSe]:GATE:STATe?
Title:
Gated Sweep State
Description:
Sets or queries the status of the Gated Sweep functionality. Usage requires Option 0090.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
[:SENSe]:GATE:TRIGger <GPS|EXT1|EXT2>
[:SENSe]:GATE:TRIGger?
Title:
Gated Sweep Trigger Source
Description:
Sets or queries the trigger source used for the Gated Sweep functionality.
Parameter(s):
<GPS|EXT1|EXT2>
Query Return:
GPS|EXT1|EXT2
Default Value:
GPS
[:SENSe]:GSCNumber <numeric_value>
[:SENSe]:GSCNumber?
Title:
Global Sync Channel Number
Description:
Sets or queries the Global Sync Channel Number for the current demod measurement. Accepted values vary based on the current operating band and absolute RF channel number. Inputting invalid values will set the closest valid value possible for the given circumstances.
When the operating band is not being used ([:SENSe]:OBANd is INValid), this value will not be settable. Attempts to set this when the system is in this state will return the error -221.
Parameter(s):
<numeric_value>
Query Return:
Numeric
Default Value:
2
Range:
2 to 26639
[:SENSe]:IQ:BITS <F32|I32|I16|I10|I8>
[:SENSe]:IQ:BITS?
Title:
IQ Sample Format
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:
Value Bits per sample Samples per frame Type
F32 32 1 floating point
I32 32 1 integer
I16 16 2 integer
I10 10 3 integer
I8 8 4 integer
Parameter(s):
<F32|I32|I16|I10|I8>
Query Return:
F32|I32|I16|I10|I8
Default Value:
F32
[:SENSe]:IQ:CONCatenate[:STATe] <0 | 1 | ON | OFF>
[:SENSe]:IQ:CONCatenate[:STATe]?
Title:
IQ Stream Concatenate State
Description:
Determines whether IQ data files produced during streaming are combined into one file when streaming ends. If set to ON, IQ streams will result in one data file. If set to OFF, IQ streams will result in many individual files with indices in the file names to indicate order. The many individual files will be grouped into a folder named with the datetime of the start of the stream. Setting this to OFF can significantly improve file saving times.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
[:SENSe]:IQ:DISCard
Title:
IQ Discard
Description:
Stops any IQ capture or stream in progress and discards all data.
[:SENSe]:IQ:FPGA:SWITch <PCIe|IQC>
Title:
Swtich FPGA Image to Configure Data Out Port
Description:
This command switchs the FPGA image to configure Data Out port for IQ data streaming.
Options:
PCIe: Streaming IQ data though Data Out port without data conversion.
IQC: Streaming IQ data to data converter device though Data Out port.
Parameter(s):
<PCIe|IQC>
[:SENSe]:IQ:LENGth <numeric_value> {PS | NS | US | MS | S | MIN | HR}
[:SENSe]:IQ:LENGth?
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
Parameter(s):
<numeric_value> {PS | NS | US | MS | S | MIN | HR}
Query Return:
Numeric (ms)
Default Value:
10000 ms
Default Unit:
ms
Range:
0.001 ms to 100000000 ms
[:SENSe]:IQ:LENGth:MAX?
Title:
IQ Capture Max Length
Description:
This command returns max IQ Capture length due to available memory space in the selected storage device.
Query Return:
Numeric (ms)
Default Value:
0.001 ms
Default Unit:
ms
Range:
0 ms to 90000000 ms
[:SENSe]:IQ:MEMory?
Title:
IQ Available Memory
Description:
This command returns available memory size for IQ Capture in the selected storage device. The value may be less than the free space on the selected storage device because it's limited to the size of the IQ data buffer.
Query Return:
Numeric
Default Value:
0
Range:
0 to INFINITY
[:SENSe]:IQ:MEMory:STREam?
Title:
IQ Stream Available Memory
Description:
This command returns available memory size for IQ Stream in the selected storage device.
Query Return:
Numeric
Default Value:
0
Range:
0 to INFINITY
[:SENSe]:IQ:METadata?
Title:
Query IQ Data
Description:
Queries the current Metadata of ongoing or previosuly completed capture/stream.
If no capture/stream has been initiated since instrument has been powered on, a data out of range error will be added to the SCPI error queue. If the command is sent before some data has been populated, some fields will show as "nan" or "Unknown".
An example of returned IQ capture/stream data is as follows: <?xml version="1.0" encoding="UTF-8"?>
<metadata>
<DataFile Value="Capture_20200731T114504.278_225381550ns_37850040000_1e+8.dgz"/>
<Vendor Value="Anritsu"/>
<Model Value="MS27201A"/>
<CenterFrequency Value="37850040000" Units="Hz"/>
<CaptureBandwidth Value="1.1e+8" Units="Hz"/>
<SampleRate Value="2e+8" Units="Hz"/>
<Span Value="1e+8" Units="Hz"/>
<ReferenceLevel Value="-40" Units="dBm"/>
<Attenuation Value="0" Units="dB"/>
<PreampState Value="1"/>
<IFFilterBandwidth Value="750e+3" Units="Hz"/>
<TriggerType Value="SING"/>
<TriggerSource Value="IMM"/>
<TriggerTime Value="0"/>
<TriggerOffset Value="0"/>
<TriggerDelay Value="0" Units="µs"/>
<Latitude Value="32.7712"/>
<Longitude Value="-117.146"/>
<GpsFix Value="1"/>
<CaptureStart Value="2020-07-31T11:45:04"/>
<ClockOffset Value="2.25382e+8"/>
<ScaleFactor Value="0.316228"/>
<BytesPerFrame Value="8"/>
<BitsPerSample Value="32"/>
<EmbeddedTimestamp Value="1"/>
<LittleEndian Value="1"/>
<IQInterleave Value="1"/>
<SignedValues Value="1"/>
<DataEncoding Value="F32"/>
<IQReversed Value="0"/>
<SampleCount Value="8000000"/>
<HardwareErrors ADCOverRange="0" DeviceAccess="0" EEPROM="0" IrregularData="0" Limit="0" LockLO1="0" LockLO2="0"
NoCal="0" Overpower="0" SLOLock="0" Saturation="0" TgLockLo1="0"/>
</metadata>
[:SENSe]:IQ:MODE <SINGle|STREam|CONTinuous>
[: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
3.Continuous mode takes consecutive single block captures
Parameter(s):
<SINGle|STREam|CONTinuous>
Query Return:
SING|STRE|CONT
Default Value:
SINGle
[:SENSe]:IQ:PORT <DATaout|USB|ETHernet>
[:SENSe]:IQ:PORT?
Title:
IQ Streaming Output Port Type
Description:
This command sets or queries the IQ Streaming output port type.
DATaout will stream IQ data to the Data Out port.
USB will stream IQ data to the USB device.
Parameter(s):
<DATaout|USB|ETHernet>
Query Return:
DAT|USB|ETH
Default Value:
ETHernet
[:SENSe]:IQ:PORT:DATAout?
Title:
IQ DataOut Type
Description:
This command queries the Data Out port type.
IQC will stream IQ data to a data converter device using the Data Out port.
PCIe will stream IQ data though the Data Out port without conversion.
The data out port can be enabled using IQ:PORT command.
Query Return:
IQC|PCI
Default Value:
IQC
[:SENSe]:IQ:SAMPle <SB1|SB2|SB3|SB4|SB5|SB6|SB7|SB8|SB9|SB10|SB11|SB12|SB13|SB14|SB15|SB16|SB17|SB18|SB19|SB20>
[:SENSe]:IQ:SAMPle?
Title:
IQ Sample Rate and Bandwidth
Description:
This command sets or queries the sample rate and bandwidth value pair for IQ Capture or IQ Streaming. For lower rates the usable bandwith listed is the nominal bandwith of the DDC anti aliasing filters.
Value Sample Rate(MHz) Bandwidth(MHz)
SB1 200 110
SB2 122.88 100
SB3 100 80
SB4 92.16 74
SB5 61.44 50
SB6 50 40
SB7 46.08 36
SB8 30.72 25
SB9 25 20
SB10 23.04 18
SB11 15.36 12
SB12 12.5 10
SB13 7.68 6
SB14 6.25 5
SB15 3.84 3
SB16 3.125 2.5
SB17 1.92 1.5
SB18 1.5625 1.25
SB19 0.36 0.28
SB20 0.045 0.036
Parameter(s):
<SB1|SB2|SB3|SB4|SB5|SB6|SB7|SB8|SB9|SB10|SB11|SB12|SB13|SB14|SB15|SB16|SB17|SB18|SB19|SB20>
Query Return:
SB1|SB2|SB3|SB4|SB5|SB6|SB7|SB8|SB9|SB10|SB11|SB12|SB13|SB14|SB15|SB16|SB17|SB18|SB19|SB20
Default Value:
SB1
[: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. (Command only available in Spectrum and RTSA)
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 available 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:SAVE:PROGress?
Title:
IQ Saving Progress
Description:
This command returns a number between 0-100 that represents the percent completion of the task of saving the IQ data to a file.
Query Return:
Percent
Default Value:
100
Range:
0% to 100%
[:SENSe]:IQ:STATus?
Title:
IQ Capture Status
Description:
This command returns current IQ Capture or IQ Streaming status.
Status description:
CONTinuous indicates continuous IQ capture is in progress.
SINGle indicates single IQ capture is in progress.
STREaming indicates IQ streaming is in progress.
READy indicates the instrument is ready for new IQ capture.
SAVing indicates that we are saving capture data into a file.
Query Return:
CONT|SING|STRE|READ|SAV
Default Value:
READy
[: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?.
=============================================================
MS2710xa:
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.
============================================================
MS27201A:
Default is set to ON.
Frame chunks are composed of 64 frames of 64-bits in length. Each frame uses the least-significant bit of each I and Q sample for timestamping.
If SENS:IQ:BITS is I10, the timestamp does not reduce resolution.
If SENS:IQ:BITS is F32, I32, I16, or I8, the timestamp reduces the resolution by one bit.
In the F32, I32 cases, each sample is 31 bits. In the I16 case, 1/2 samples are 15 bits. In the I8 case, 1/4 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 10 bits because there are extra, otherwise unused bits.
The timestamps are shift-encoded in groups of 64 in bit 64, and there is a shift-encoded mark in bit 32.
If GPS is not enabled, timestamps will use Internal PPS time. Enabling timestamps does not automatically enable GPS.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
ON
[:SENSe]:LTE:CFI <AUTO|CFI1|CFI2|CFI3>
[:SENSe]:LTE:CFI?
Title:
CFI Selection
Description:
Sets or queries the Control Format Indicator for the current LTE measurement.
Valid selections are: AUTO, 1, 2, or 3.
Parameter(s):
<AUTO|CFI1|CFI2|CFI3>
Query Return:
AUTO|CFI1|CFI2|CFI3
Default Value:
AUTO
[:SENSe]:LTE:OBANd <INValid|UL1|DL1|UL2|DL2|UL3|DL3|UL4|DL4|UL5|DL5|UL6|DL6|UL7|DL7|UL8|DL8|UL9|DL9|UL10|DL10|UL11|DL11|UL12|DL12|UL13|DL13|UL14|DL14|UL17|DL17|UL18|DL18|UL19|DL19|UL20|DL20|UL21|DL21|UL22|DL22|UL23|DL23|UL24|DL24|UL25|DL25|UL26|DL26|UL27|DL27|UL28|DL28|DL29|UL30|DL30|UL31|DL31|DL32|UL33|DL33|UL34|DL34|UL35|DL35|UL36|DL36|UL37|DL37|UL38|DL38|UL39|DL39|UL40|DL40|UL41|DL41|UL42|DL42|UL43|DL43|UL44|DL44|UL45|DL45|UL46|DL46|UL47|DL47|UL48|DL48|UL50|DL50|UL51|DL51|UL52|DL52|UL66|DL66|UL71|DL71>
[:SENSe]:LTE:OBANd?
Title:
Operating Band Number
Description:
Sets or queries the operating band number for the current demod measurement.
Parameter(s):
<INValid|UL1|DL1|UL2|DL2|UL3|DL3|UL4|DL4|UL5|DL5|UL6|DL6|UL7|DL7|UL8|DL8|UL9|DL9|UL10|DL10|UL11|DL11|UL12|DL12|UL13|DL13|UL14|DL14|UL17|DL17|UL18|DL18|UL19|DL19|UL20|DL20|UL21|DL21|UL22|DL22|UL23|DL23|UL24|DL24|UL25|DL25|UL26|DL26|UL27|DL27|UL28|DL28|DL29|UL30|DL30|UL31|DL31|DL32|UL33|DL33|UL34|DL34|UL35|DL35|UL36|DL36|UL37|DL37|UL38|DL38|UL39|DL39|UL40|DL40|UL41|DL41|UL42|DL42|UL43|DL43|UL44|DL44|UL45|DL45|UL46|DL46|UL47|DL47|UL48|DL48|UL50|DL50|UL51|DL51|UL52|DL52|UL66|DL66|UL71|DL71>
Query Return:
INV|UL1|DL1|UL2|DL2|UL3|DL3|UL4|DL4|UL5|DL5|UL6|DL6|UL7|DL7|UL8|DL8|UL9|DL9|UL10|DL10|UL11|DL11|UL12|DL12|UL13|DL13|UL14|DL14|UL17|DL17|UL18|DL18|UL19|DL19|UL20|DL20|UL21|DL21|UL22|DL22|UL23|DL23|UL24|DL24|UL25|DL25|UL26|DL26|UL27|DL27|UL28|DL28|DL29|UL30|DL30|UL31|DL31|DL32|UL33|DL33|UL34|DL34|UL35|DL35|UL36|DL36|UL37|DL37|UL38|DL38|UL39|DL39|UL40|DL40|UL41|DL41|UL42|DL42|UL43|DL43|UL44|DL44|UL45|DL45|UL46|DL46|UL47|DL47|UL48|DL48|UL50|DL50|UL51|DL51|UL52|DL52|UL66|DL66|UL71|DL71
Default Value:
INValid
[:SENSe]:MIMO:ANTenna:PORT <AUTO|ANT0|ANT1|ANT2|ANT3>
[:SENSe]:MIMO:ANTenna:PORT?
Title:
Antenna Port
Description:
Sets or queries the antenna port for the MIMO measurement.
Valid selections are: Auto (for autodetect), ANT0, ANT1, ANT2, and ANT3.
Parameter(s):
<AUTO|ANT0|ANT1|ANT2|ANT3>
Query Return:
AUTO|ANT0|ANT1|ANT2|ANT3
Default Value:
AUTO
[:SENSe]:MODE <SPECtrum|NRADio|LTE>
[:SENSe]:MODE?
Title:
Spa mode
Description:
Set the operational mode of the Spa app.
SPECtrum for the default spectrum mode.
NRADio for 5G measurement mode.
RTSA for real time spectrum analysis mode.
LTE for 4G measurement mode.
Parameter(s):
<SPECtrum|NRADio|LTE>
Query Return:
SPEC|NRAD|LTE
Default Value:
SPECtrum
[:SENSe]:MODE:CATalog?
Title:
Spa Mode Catalog
Description:
Returns a list of available modes for the Spa application. The response is a comma-separated list of mode names. See command [:SENSe]:MODE for the mode name specification.
[:SENSe]:MODulation:REFerence?
Title:
Modulation Reference Point
Description:
Queries the reference points for the current modulation type.
[:SENSe]:MODulation:TYPE <ALL|QPSK|Q16|Q64|Q256>
[:SENSe]:MODulation:TYPE?
Title:
Modulation Type
Description:
Sets or queries the modulation type for the current LTE or 5G measurement. Only QPSK is available in 5G measurement.
Valid selections are: ALL, QPSK, Q16 (16-QAM), Q64 (64-QAM), and Q256 (256-QAM).
Parameter(s):
<ALL|QPSK|Q16|Q64|Q256>
Query Return:
ALL|QPSK|Q16|Q64|Q256
Default Value:
ALL
[:SENSe]:NGFactor <ONESixth|HALF|ONE|TWO>
[:SENSe]:NGFactor?
Title:
Ng Factor
Description:
Sets or queries the Ng factor for the number of PHICH groups calculation.
Apply to TDD duplex type only.
Valid selections are: ONESixth (1/6), HALF (1/2), ONE (1), and TWO (2).
Parameter(s):
<ONESixth|HALF|ONE|TWO>
Query Return:
ONES|HALF|ONE|TWO
Default Value:
ONESixth
[:SENSe]:NRADio:MAPPing:PATTern <P1|P2|AUTO>
[:SENSe]:NRADio:MAPPing:PATTern?
Title:
Mapping Pattern
Description:
Sets or queries the Mapping Pattern used in the New Radio mode.
Available selections are: P1 (Mapping Pattern 1), or P2 (Mapping Pattern 2)
Parameter(s):
<P1|P2|AUTO>
Query Return:
P1|P2|AUTO
Default Value:
AUTO
[:SENSe]:OBANd <INValid|GLOBal|N1|N2|N3|N5|N7|N8|N12|N14|N18|N20|N25|N26|N28|N29|N30|N34|N38|N39|N40|N41|N46|N48|N50|N51|N53|N65|N66|N70|N71|N74|N75|N76|N77|N78|N79|N90|N91|N92|N93|N94|N96|N257|N258|N259|N260|N261>
[:SENSe]:OBANd?
Title:
Operating Band Number
Description:
Sets or queries the operating band number for the current demod measurement. Sets via this command will also restrict available ARF and GS Channel numbers Currently supports bands: N1,N2,N3,N5,N7,N8,N12,N14,N18,N20,N25,N26,N28,N29,N30,N34,N38,N39,N40,N41,N46,N48,N50,N51,N53,
N65,N66,N70,N71,N74,N75,N76,N77,N78,N79,N90,N91,N92,N93,N94,N96,N257,N258,N259,N260,N261
Band availability may be limited by options purchased.
Parameter(s):
<INValid|GLOBal|N1|N2|N3|N5|N7|N8|N12|N14|N18|N20|N25|N26|N28|N29|N30|N34|N38|N39|N40|N41|N46|N48|N50|N51|N53|N65|N66|N70|N71|N74|N75|N76|N77|N78|N79|N90|N91|N92|N93|N94|N96|N257|N258|N259|N260|N261>
Query Return:
INV|GLOB|N1|N2|N3|N5|N7|N8|N12|N14|N18|N20|N25|N26|N28|N29|N30|N34|N38|N39|N40|N41|N46|N48|N50|N51|N53|N65|N66|N70|N71|N74|N75|N76|N77|N78|N79|N90|N91|N92|N93|N94|N96|N257|N258|N259|N260|N261
Default Value:
INValid
[: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>
[:SENSe]:OBWidth:PERCent?
Title:
Occupied Bandwidth Percent
Description:
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.
Parameter(s):
<numeric_value>
Query Return:
Numeric
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}
[:SENSe]:OBWidth:XDB?
Title:
Occupied Bandwidth XDB
Description:
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.
Parameter(s):
<numeric_value> {DB}
Query Return:
Numeric (dB)
Default Value:
3 dB
Default Unit:
dB
Range:
0.001 dB to 100 dB
[:SENSe]:PCI?
Title:
Get PCI Measurements
Description:
Returns the last stored PCI measurement results. This command returns cell id, group id, corrected carrier frequency, detected beam,
frame start, frequency error, sector id, group id, and time offset(in ns) as output in json format.
This command does not wait for the current measurement to complete before returning results.
An example is as follows:
{
"carrierId":1,
"cellId": 0,
"cellIdGroup": 0,
"correctedCarrierFrequency": 4499999985.264854,
"detectedBeam": 4,
"frameStart": 233097,
"frequencyError": -14.735145792134368,
"ppmFrequencyError": 0.09346635883256266,
"sectorId": 0,
"status": {
"hardwareErrors": {
"ADCOverRange": 0,
"DeviceAccess": 0,
"EEPROM": 0,
"IrregularData": 0,
"Limit": 0,
"LockLO1": 0,
"LockLO2": 0,
"NoCal": 0,
"Overpower": 0,
"SLOLock": 0,
"Saturation": 0,
"TgLockLo1": 0
},
"statusMessage": "statusPciDone",
"statusNumber": 10
},
"gps":{
"coordinates":"37.14681, -121.65609, 128m",
"time":"Fri Jun 28 19:56:45 2019 GMT"
},
"timeOffset": -634782.9687499882
}
[:SENSe]:POWer:RF:ATTenuation <numeric_value> {DB}
[:SENSe]:POWer:RF:ATTenuation?
Title:
Input Attenuation
Description:
Sets the input attenuation. Note that issuing this command will set the automatic input attenuation OFF. Actual minimum and maximum values vary, depending on model and options.
See UNIT:POWer to query or set the current amplitude units.
Parameter(s):
<numeric_value> {DB}
Query Return:
Numeric (dB)
Default Value:
30 dB
Default Unit:
dB
Range:
0 dB to 65 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:AUTO <0 | 1 | ON | OFF>
[:SENSe]:POWer:RF:GAIN:AUTO?
Title:
Auto Gain Ranging
Description:
Sets the state of the auto gain-ranging functionality.
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
[:SENSe]:SCANner?
Title:
Get Cell Scanner
Description:
Returns the cell scanner measurements in a json format. unlike [:SENSe]:FETCH:SCANner this command does not block and will return the previous result. Returned data format varies based on whether the current mode is 5GNR or LTE.
5GNR Mode format:
{
"carrierId":1,
"gps":{
"coordinates":"37.14681, -121.65609, 128m",
"time":"Fri Jun 28 19:56:45 2019 GMT"
},
"status":{
"hardwareErrors":{
"ADCOverRange":0,
"DeviceAccess":0,
"EEPROM":0,
"IrregularData":0,
"Limit":0,
"LockLO1":0,
"LockLO2":0,
"NoCal":0,
"Overpower":0,
"SLOLock":0,
"Saturation":0,
"TgLockLo1":0
},
"statusMessage":"statusCellScannerDone",
"statusNumber":13
},
"values":[
{
"cellId":1007,
"cellIdGroup":335,
"frameStart":1920521,
"sectorId":0,
"timeOffset":-3490194.091145895,
"values":[
{
"beamIndex":0,
"beamPresent":1,
"ssRmsEvm":6.488177299499512,
"ssRsrp":-67.18608535715634,
"ssRsrq":-9.913812153567978,
"ssSinr":23.757546218871823
},
...
{
"beamIndex":7,
"beamPresent":1,
"ssRmsEvm":6.488177299499512,
"ssRsrp":-84.22420720274197,
"ssRsrq":null,
"ssSinr":null
}
]
}
]
}
LTE Mode format:
{
"carrierId":1,
"gps":{
"coordinates":"nan, nan,nanm","time":""
},
"status":{
"hardwareErrors":{
"ADCOverRange":0,
"DeviceAccess":0,
"EEPROM":0,
"IrregularData":0,
"Limit":0,
"LockLO1":0,
"LockLO2":0,
"NoCal":0,
"Overpower":0,
"SLOLock":0,
"Saturation":0,
"TgLockLo1":0
},
"statusMessage":"statusCellScannerDone",
"statusNumber":13
},
"values":[
{
"cellId":2,
"cellIdGroup":0,
"crsRsrp":-68.46522521972656,
"crsRsrq":0.2733601927757263,
"crsSinr":34.74685287475586,
"dominance":null,
"dominantCell":true,
"frameStart":-1,
"frequencyError":227.3341827392578,
"pbch":{
"peakEvm":{
"percent":4.949735641479492,
"subcarrierNumber":-1,
"symbolNumber":-1
},
"rmsEvm":2.2826967239379883
},
"ppmFrequencyError":0.06495262363978795,
"sectorId":2,
"ssRsrp":-68.43709564208984
}
]
}
[:SENSe]:SCANner:STATe <0 | 1 | ON | OFF>
[:SENSe]:SCANner:STATe?
Title:
Demod Scanner State Command
Description:
Turns on cell scanner, disables other measurements
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
[:SENSe]:SEMask:CENTer:BWIDth <numeric_value> {HZ | KHZ | MHZ | GHZ}
[:SENSe]:SEMask:CENTer:BWIDth?
Title:
Center Channel Bandwidth
Description:
Set or query the bandwidth of the central channel of the Spectral Emission Mask measurement. The center channel is used to calculate the reference power when reference power calculation is set to AUTO.
Parameter(s):
<numeric_value> {HZ | KHZ | MHZ | GHZ}
Query Return:
Numeric (Hz)
Default Value:
100000000 Hz
Default Unit:
Hz
Range:
10000 Hz to 1000000000 Hz
[:SENSe]:SEMask:MASK <GT38|LT38|CUSTom>
[:SENSe]:SEMask:MASK?
Title:
Spectral Mask
Description:
Sets the preprogrammed spectral mask to be use for the Spectral Emission Mask measurement. Available selections are specified in the following table: Spectral Mask Description GT38 5G NR P > 38 dBm LT38 5G NR P < 38 dBm CUSTom User Defined Mask from [:SENSe]:SEMask:MASK:CUSTom\
Parameter(s):
<GT38|LT38|CUSTom>
Query Return:
GT38|LT38|CUST
Default Value:
GT38
[:SENSe]:SEMask:MASK:CUSTom <string>,<block data>
[:SENSe]:SEMask:MASK:CUSTom?
Title:
Custom Spectral Emission Mask Segment Data
Description:
This command takes String as a name and imports file contents to the instrument. Data is transferred to the instrument as an IEEE definite length arbitrary block response, which has the form <header><block>.
Sting Value: The name value sent
Block Data: The data to be written to the instrument in block data format
Please note that the maximum file transfer size to the instrument is 25 MB. The ASCII header specifies the number of data bytes of the file. 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 contents of the block data should format to csv with each line being a segment in the custom SEM.
Needed values for a segment are: startFrequency, stopFrequency, rbw, vbw, isStartAmpRelative, isStopAmpRelative, startAmplitude, stopAmplitude Start and Stop Frequencies are relative to the center frequency.
Example of a properly formatted mask: -4.00e7,-1.01e7,1.00e6,1.00e5,0,0,-15,-15 1.01e7,4.00e7,1.00e6,1.00e5,0,0,-15,-15
Query returns a String formatted as Json with name: and mask: as the keys
example:
{ name: maskname, mask: -4.00e7,-1.01e7,1.00e6,1.00e5,0,0,-15,-15
1.01e7,4.00e7,1.00e6,1.00e5,0,0,-15,-15 }\
Parameter(s):
<string>,<block data>
Default Value:
{\"name\":\"example.csv\"}
[:SENSe]:SEMask:RPOWer <numeric_value> {<amplitude_units>}
[:SENSe]:SEMask:RPOWer?
Title:
Manual Reference Power
Description:
Set or query the manual reference power value used in the Spectral Emission Mask measurement when reference power calculation method ([SENSe]:SEMask:RPOWer:STATe) is set to OFF or 0. When the reference power calculation method is set to ON or 1, this manual reference power value will be unused.
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:
-200 dBm to 200 dBm
[:SENSe]:SEMask:RPOWer:STATe <0 | 1 | ON | OFF>
[:SENSe]:SEMask:RPOWer:STATe?
Title:
Reference Power Calculation
Description:
Set or query the method for how the reference power is calculated in the Spectral Emission Mask measurement. Setting the value to ON or 1, the reference power will be obtained automatically by measuring the channel power of the center channel bandwidth. Setting the value to OFF or 0, the reference power will be the value set using the manual reference power command ([:SENSe]:SEMask:RPOWer).
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
ON
[:SENSe]:SEMask:STATe <0 | 1 | ON | OFF>
[:SENSe]:SEMask:STATe?
Title:
Spectral Emission Mask State
Description:
Sets the state of the Spectral Emission Mask measurement, ON or OFF. When using :CONFigure:SEMask,the state is automatically set to ON.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
[:SENSe]:SSB?
Title:
Get SSB Measurements
Description:
Returns the last stored SSB measurement results.
This command returns the beam numbers with the best EVM and power, followed by Power and EVM results
for PSS, SSS, PBCH, PBCH DM-RS and SS Signal Quality Results in a json format.
This command does not wait for the current measurement to complete before returning results.
eg:
{
"bestEvmBeam":5,
"bestPowerBeam":0,
"status": {
"hardwareErrors": {
"ADCOverRange": 0,
"DeviceAccess": 0,
"EEPROM": 0,
"IrregularData": 0,
"Limit": 0,
"LockLO1": 0,
"LockLO2": 0,
"NoCal": 0,
"Overpower": 0,
"SLOLock": 0,
"Saturation": 0,
"TgLockLo1": 0
},
"statusMessage": "statusPciDone",
"statusNumber": 10
},
"gps":{
"coordinates":"37.14681, -121.65609, 128m",
"time":"Fri Jun 28 19:56:45 2019 GMT"
},
"values":[
{
"dmRsPbch":{
"peakEvm":{
"percent":11.926020622253418,
"subcarrierNumber":1529,
"symbolNumber":3
},
"power":-31.813847928749347,
"rmsEvm":3.813983917236328
},
"pbch":{
"peakEvm":{
"percent":13.430730819702148,
"subcarrierNumber":1638,
"symbolNumber":5
},
"power":-31.8139914869584,
"rmsEvm":3.736370325088501
},
"pss":{
"peakEvm":{
"percent":12.912864685058594,
"subcarrierNumber":1638,
"symbolNumber":2
},
"power":-31.704519932556128,
"rmsEvm":1.7515575885772705
},
"ssRsrp":-31.750750515723816,
"ssRsrq":-10.728772378478801,
"ssSinr":-13.878087163543444,
"sss":{
"peakEvm":{
"percent":11.369827270507812,
"subcarrierNumber":1638,
"symbolNumber":4
},
"power":-31.750750515723816,
"rmsEvm":2.5253000259399414
}
},
{ ... },
{ ... },
{ ... },
{ ... },
{ ... },
{ ... },
{ ... }
]
}
[:SENSe]:SSB:FREQuency <numeric_value> {HZ | KHZ | MHZ | GHZ}
[:SENSe]:SSB:FREQuency?
Title:
SSB Frequency
Description:
Sets or queries the SS Block center frequency in Hz.
Parameter(s):
<numeric_value> {HZ | KHZ | MHZ | GHZ}
Query Return:
Numeric (Hz)
Default Value:
0 Hz
Default Unit:
Hz
Range:
-100000000000 Hz to 300000000000 Hz
[:SENSe]:SSB:OFFSet <numeric_value> {HZ | KHZ | MHZ | GHZ}
[:SENSe]:SSB:OFFSet?
Title:
SSB Frequency Offset
Description:
Sets or queries the SS Block frequency offset from the current center frequency in Hz.
Parameter(s):
<numeric_value> {HZ | KHZ | MHZ | GHZ}
Query Return:
Numeric (Hz)
Default Value:
0 Hz
Default Unit:
Hz
Range:
-200000000000 Hz to 200000000000 Hz
[:SENSe]:SSB:OFFSet:AUTO:ABORt
Title:
SSB Autodetection Abort
Description:
Aborts the current SSB Autodetection operation. System may take several seconds before the current operation terminates completely. The [:SENSe]:SSB:OFFSet:AUTO:STATus query
will return "ABOR" when complete.
[:SENSe]:SSB:OFFSet:AUTO:STARt
Title:
SSB Autodetection Start
Description:
Starts the SSB Autodetection operation.
[:SENSe]:SSB:OFFSet:AUTO:STATus?
Title:
SSB Autodetection Status
Description:
Queries the current status of the SSB Autodetection operation. Valid values are:
INACtive: Operation has not been performed with the current set of parameters. ACTive: Operation is in progress. EXTended: Extensive search is in progress. PASS: Operation has completed successfully, and the new SSB Offset has been applied. FAIL: Operation has completed, but did not find a valid SSB. ABORted: Operation was aborted before completion.
Query Return:
INAC|ACT|EXT|PASS|FAIL|ABOR
Default Value:
INACtive
[:SENSe][:SSB]:SCSPacing <numeric_value> {HZ | KHZ | MHZ | GHZ}
[:SENSe][:SSB]:SCSPacing?
Title:
SSB Subcarrier Spacing
Description:
Sets or queries the SS Block subcarrier spacing for the current demod measurement.
Full set of possible values are 15, 30, 120, 240 kHz.
Parameter(s):
<numeric_value> {HZ | KHZ | MHZ | GHZ}
Query Return:
Numeric (Hz)
Default Value:
30000 Hz
Default Unit:
Hz
Range:
15000 Hz to 240000 Hz
[:SENSe][:SSB]:SCSPacing:CATalog?
Title:
SSB Subcarrier Spacing Catalog
Description:
Queries a list of all valid SS block subcarrier spacing values based on current settings.
Data is returned in a comma-separated list of frequencies in Hz, e.g. "15000,30000,60000"
Default Value:
15000,30000,120000,240000
[:SENSe]:SUBFrame <numeric_value>
[:SENSe]:SUBFrame?
Title:
Subframe Number
Description:
Sets or queries the subframe number for the current LTE or 5G measurement.
Values range from 0-9.
Parameter(s):
<numeric_value>
Query Return:
Numeric
Default Value:
0
Range:
0 to 9
[:SENSe]:SUBFrame:CONFiguration <AUTO|SSF0|SSF1|SSF2|SSF3|SSF4|SSF5|SSF6|SSF7|SSF8|SSF9|INValid>
[:SENSe]:SUBFrame:CONFiguration?
Title:
Special Subframe Configuration
Description:
Sets or queries the special subframe configuration for the current LTE measurement.
Parameter(s):
<AUTO|SSF0|SSF1|SSF2|SSF3|SSF4|SSF5|SSF6|SSF7|SSF8|SSF9|INValid>
Query Return:
AUTO|SSF0|SSF1|SSF2|SSF3|SSF4|SSF5|SSF6|SSF7|SSF8|SSF9|INV
Default Value:
SSF0
[:SENSe]:SUBFrame:SLOT <numeric_value>
[:SENSe]:SUBFrame:SLOT?
Title:
Slot Number
Description:
Sets or queries the slot number of the current selected subframe in the LTE or 5G frame power measurement.
Values range from 0-1.
Parameter(s):
<numeric_value>
Query Return:
Numeric
Default Value:
0
Range:
0 to 1
[:SENSe]:SWEep:TIMe <numeric_value> {PS | NS | US | MS | S | MIN | HR}
[:SENSe]:SWEep:TIMe?
Title:
Sweep Time
Description:
Sets the value of the minimum sweep time parameter. The sweep will complete in the shortest time possible greater than the specified time. To sweep as fast as possible, enter the minimum value allowed for the sweep time. Applies to zero span sweeps only.
Parameter(s):
<numeric_value> {PS | NS | US | MS | S | MIN | HR}
Query Return:
Numeric (ms)
Default Value:
30000 ms
Default Unit:
ms
Range:
0.02 ms to 60000 ms
[:SENSe]:SYNCtype <SS>
[:SENSe]:SYNCtype?
Title:
Sync Type
Description:
Sets or queries the sync type, currently only SS is available for 5GNR
Parameter(s):
<SS>
Query Return:
SS
Default Value:
SS
[:SENSe]:TDOMain:DISPlay:LENGth <numeric_value> {PS | NS | US | MS | S | MIN | HR}
[:SENSe]:TDOMain:DISPlay:LENGth?
Title:
Time Domain Display Length
Description:
Sets or queries the duration of the Time Domain measurements display's measurement. Available values are limited to 100us - 200ms.
Parameter(s):
<numeric_value> {PS | NS | US | MS | S | MIN | HR}
Query Return:
Numeric (ms)
Default Value:
20 ms
Default Unit:
ms
Range:
0.1 ms to 200 ms
[:SENSe]:TDOMain:DISPlay:STARt <numeric_value> {PS | NS | US | MS | S | MIN | HR}
[:SENSe]:TDOMain:DISPlay:STARt?
Title:
Time Domain Display Start Time
Description:
Sets or queries the start time of the display for the Time Domain measurement. Available values are limited to 0 - 199.9ms.
Parameter(s):
<numeric_value> {PS | NS | US | MS | S | MIN | HR}
Query Return:
Numeric (ms)
Default Value:
0 ms
Default Unit:
ms
Range:
0 ms to 199.9 ms
[:SENSe]:TDOMain:STATe <0 | 1 | ON | OFF>
[:SENSe]:TDOMain:STATe?
Title:
Time Domain State
Description:
Enables and disables time domain mode
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
[:SENSe]:UPDown:CONFig <numeric_value>
[:SENSe]:UPDown:CONFig?
Title:
Up/Down Link Config
Description:
Sets or queries the current up/down link config setting. This setting is only available when duplex type is set to TDD
Parameter(s):
<numeric_value>
Query Return:
Numeric
Default Value:
0
Range:
0 to 6
: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.
10 1024 Not implemented
11 2048 Not implemented
12 4096 Not implemented
13 8192 Not implemented
14 16384 Not implemented
15 0 Will always be 0
:THReshold:SINR <numeric_value> {DB}
:THReshold:SINR?
Title:
Sinr threshold
Description:
Sets or queries SINR threshold for display. Values below the threshold will not be shown. This only affects the display and does not change the contents of any other measurement data SCPI queries.
See UNIT:POWer to query or set the current amplitude units.
Parameter(s):
<numeric_value> {DB}
Query Return:
Numeric (dB)
Default Value:
6 dB
Default Unit:
dB
Range:
-50 dB to 50 dB
: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.
Note that once data is requested, all of it must be read on the controller side. The instrument will block further SCPI processing until each data transfer is complete. If a data transfer remains incomplete for long enough it could cause error messages to be displayed until either all of the data is read or the connection where the transfer is taking place is closed.
Parameter(s):
[<numeric_value>]
TRACe Suffix Range:
0, Default = 0
:TRACe<n>:DETector[:FUNCtion] <POSitive|RMS|NEGative|SAMPle>
:TRACe<n>:DETector[:FUNCtion]?
Title:
Trace Detector Type
Description:
Sets the detection method for the specific trace. 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. SAMPle detection selects one of the associated measurement points to display. This command will be ignored when spectrogram is enabled by DISPlay:VIEW. In zero span and RTSA mode the SAMPle detection replaces RMS detection.
Parameter(s):
<POSitive|RMS|NEGative|SAMPle>
Query Return:
POS|RMS|NEG|SAMP
TRACe Suffix Range:
1-6, Default = 1
Default Value:
POSitive
:TRACe<n>:DISPlay[:STATe] <0 | 1 | ON | OFF>
:TRACe<n>:DISPlay[:STATe]?
Title:
Trace Display State
Description:
The trace visibility state. If it is OFF, the :TRAC:DATA? command will return nan.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
TRACe Suffix Range:
1-6, Default = 1
Default Value:
ON
:TRACe<n>:DISPlay:VIEW:SPECtrogram:ELAPsed?
Title:
Spectrogram Elapsed
Description:
Provides the index and time values for the specified trace based on which trace from the spectrogram history it represents.
TRACe Suffix Range:
1-6, Default = 1
:TRACe<n>:DISPlay:VIEW:SPECtrogram:POSition <numeric_value>
:TRACe<n>:DISPlay:VIEW:SPECtrogram:POSition?
Title:
Spectrogram Trace Position
Description:
The command sets the spectrogram history index that specific trace referencing to.
Parameter(s):
<numeric_value>
Query Return:
Numeric
TRACe Suffix Range:
1-6, Default = 1
Default Value:
0
Range:
0 to 600
:TRACe<n>:DISPlay:VIEW:SPECtrogram:TIME <numeric_value>
:TRACe<n>:DISPlay:VIEW:SPECtrogram:TIME?
Title:
Spectrogram Trace Time
Description:
The command select the spectrogram history trace base on elapsed time from the newest trace.
Parameter(s):
<numeric_value>
Query Return:
Numeric (ms)
TRACe Suffix Range:
1-6, Default = 1
Default Value:
0 ms
Default Unit:
ms
Range:
0 ms to 100000000 ms
:TRACe<n>:SWEep:COUNt[:CURRent]?
Title:
Trace Sweep Count
Description:
The trace sweep count returns current sweep count which can be useful for multiple-sweep measurements like average and min/max hold.
Query Return:
Numeric
TRACe Suffix Range:
1-6, Default = 1
Default Value:
0
Range:
0 to 4000000000
:TRACe<n>:TYPE <NORMal|MINimum|MAXimum|AVERage|RMAXimum|RMINimum|RAVerage>
:TRACe<n>:TYPE?
Title:
Trace Type
Description:
Specifies how successive sweeps are combined to produce the resulting display value. 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. This command will be ignored when spectrogram is enabled by DISPlay:VIEW.
Parameter(s):
<NORMal|MINimum|MAXimum|AVERage|RMAXimum|RMINimum|RAVerage>
Query Return:
NORM|MIN|MAX|AVER|RMAX|RMIN|RAV
TRACe Suffix Range:
1-6, Default = 1
Default Value:
NORMal
:TRACe<n>:UPDate[:STATe] <0 | 1 | ON | OFF>
:TRACe<n>:UPDate[:STATe]?
Title:
Trace Update State
Description:
The trace update state detemine whether the trace is update in every sweep.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
TRACe Suffix Range:
1-6, Default = 1
Default Value:
ON
: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. 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[:DATA]:ALL? [<ASCII|INTeger|REAL>],[<numeric_value>]
Title:
Trace Data All
Description:
This command transfers trace data from the instrument to the controller for all traces with display state ON (see Trace Display State commands).
The traces are returned back to back with no delimiter between traces using the the same IEEE definite length arbitrary block response of the Trace Data command.
However, after the usual header this command includes additional header information to support parsing the following data. This additional header consists of a two byte integer indicating the number of display points per trace as well as a two byte trace flags value.
The bits in the two byte trace flags value are mapped to a trace number and indicate whether that trace is included in the following data. Bit 0 is the least significant bit and is unused. Bits 1 through N are mapped to traces 1 through N. If the bit value is 1, the trace data for that trace is included in the following data. If the bit value is 0, the trace data for that trace is not included in the following data.
For example, a trace flags value of 0x4C indicates that trace data for traces 2, 3, and 6 are included in the following data. The traces are returned in increasing order. The format of the data follows the Trace Data Format setting.
An optional parameter can be given to set the format data output, the parameter follows the same enumerable value as the Trace Data format setting. When using REAL as the output format, the numeric value field is required. See the document on Trace Data Format (:FORMat[:TRACe][:DATA]) for more info.
Parameter(s):
[<ASCII|INTeger|REAL>],[<numeric_value>]
:TRACe:IQ:DATA:FORMat <PACKed>
: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\nB', where L is an ASCII string of the form 'latitude, longitude' in decimal degrees, '\n' 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").
<MS2710xA>
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>
Query Return:
PACK
Default Value:
PACKed
:TRACe:PLAYback <PLAY|STOP|PAUSe>
:TRACe:PLAYback?
Title:
Trace Playback State
Description:
This command sets or queries the Trace Playback state, which can be STARt, STOP, or PAUSe.
Parameter(s):
<PLAY|STOP|PAUSe>
Query Return:
PLAY|STOP|PAUS
Default Value:
STOP
:TRACe:PLAYback:FILE?
Title:
Current Playback File
Description:
This command queries the currently loaded playback file for the measurement.
Default Value:
None
:TRACe:PLAYback:INTerval <numeric_value> {PS | NS | US | MS | S | MIN | HR}
:TRACe:PLAYback:INTerval?
Title:
Trace Playback Interval
Description:
This command sets or queries the playback interval rate at which trace recording are being played.
The interval rate can be set from 20 milliseconds up to 5 seconds.
Parameter(s):
<numeric_value> {PS | NS | US | MS | S | MIN | HR}
Query Return:
Numeric (ms)
Default Value:
1000 ms
Default Unit:
ms
Range:
20 ms to 5000 ms
:TRACe:PLAYback:LOOP <0 | 1 | ON | OFF>
:TRACe:PLAYback:LOOP?
Title:
Loop Playback
Description:
This command sets or queries whether playback will restart at the beginning when it reaches the end of the playback file.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
:TRACe:PLAYback:POSition?
Title:
Playback Position
Description:
This command supplies information related to the current position of a playback session. It returns the total number of traces in the session in addition to the index of the last played trace along with the timestamp value as the number of milliseconds since 1970-01-01T00:00:00.000 Coordinated Universal Time(UTC) describing when the trace was recorded. A response might look like the following:
{
"traceCount":1500,
"trace":
{
"index":123,
"timestamp":1605311779428
}
}
If there isn't an active playback session all values will be 0.
Default Value:
{\"index\":0,\"timestamp\":0}
:TRACe:PLAYback:SEEK <numeric_value>
:TRACe:PLAYback:SEEK?
Title:
Trace Playback Seek
Description:
This command sets and queries the current position in a playback session. A playback session contains a list of recorded traces and the zero-based index used by this command represents the trace at that index in the list, where the trace at index 0 is the trace that was recorded first and the trace at the last index is the trace recorded last.
The set command takes an index which will be the index of the next played trace. The query command takes no parameters and returns the index of the last played trace.
Parameter(s):
<numeric_value>
Query Return:
Numeric
Default Value:
0
Range:
0 to 0
:TRACe:PLAYback:TAG <NEXT|PREVious|ADD|REMove>
Title:
Trace Playback Tag
Description:
This command skips to the next or previous tag in the playback, if one exists. It can also be used to add/remove tags in the current playback session, which will modify the session file so that the tags persist the next time it's played.
Parameter(s):
<NEXT|PREVious|ADD|REMove>
:TRACe:PLAYback:TAGS? [<RECord|PLAYback>]
Title:
Tag Info
Description:
This command returns which traces are tagged in a record or playback session. The response is in JSON format. Each tag is represented as an index and timestamp. The indices correspond to the position of the tagged trace in the full recorded history and the timestamp values are millseconds since 1970-01-01T00:00:00.000 Coordinated Universal Time(UTC) describing when the trace was recorded. The index values can be used as a parameter to the TRACe:PLAYback:SEEK command. A response might look like the following:
{
"tags":
[
{"index":3,"timestamp":1605310939565},
{"index":75,"timestamp":1605311015834}
]
}
If there is no playback or record session active, the response will be {"tags":[]} An optional parameter can be set to query the record or playback tag list.
Parameter(s):
[<RECord|PLAYback>]
Default Value:
{\"tags\":[]}
:TRACe:PLAYback:TAG:TABLe <0 | 1 | ON | OFF>
:TRACe:PLAYback:TAG:TABLe?
Title:
Playback Table
Description:
Frontend command to indicate tag table on/off
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
: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:RECord <RECord|STOP|PAUSe>
:TRACe:RECord?
Title:
Trace Recording State
Description:
This command sets or queries the Trace Recording state, which can be RECord, STOP, or PAUSe.
Parameter(s):
<RECord|STOP|PAUSe>
Query Return:
REC|STOP|PAUS
Default Value:
STOP
:TRACe:RECord:CSV:LINK <RECord|PLAYback|OFF>
:TRACe:RECord:CSV:LINK?
Title:
Enable CSV Recording during Trace Record or Trace Playback
Description:
This command sets or queries whether Trace Recording in CSV is linked to the Trace Record or Trace Playback states,
which can be RECord, PLAYback or OFF.
RECord:
Recording CSV State (TRACe:RECord:CSV:STATe) will be updated base on Trace Record State (TRACe:RECord) changes as following
Record State: Record CSV State:
RECord RECord
PAUSe PAUSe
STOP STOP
PLAYback:
Recording CSV State will be updated base on on Trace Playback State (TRACe:PLAYback) changes as following
Playback State: Record CSV State:
PLAY RECord
PAUSe PAUSe
STOP STOP
OFF:
Recording CSV State remain unaffected by Trace Record State or Trace Playback State changes.
Parameter(s):
<RECord|PLAYback|OFF>
Query Return:
REC|PLAY|OFF
Default Value:
OFF
:TRACe:RECord:CSV:STATe <RECord|STOP|PAUSe>
:TRACe:RECord:CSV:STATe?
Title:
Trace Recording CSV State
Description:
This command sets or queries whether Trace Recording will also write a CSV of the recorded data, which can be RECord, STOP, or PAUSe.
Parameter(s):
<RECord|STOP|PAUSe>
Query Return:
REC|STOP|PAUS
Default Value:
STOP
:TRACe:RECord:INTerval:MODE <AUTO|MANual>
:TRACe:RECord:INTerval:MODE?
Title:
Trace Recording Interval Mode
Description:
This command sets or queries whether Trace Recording will AUTomatically record each trace or use MANual intervals.
Parameter(s):
<AUTO|MANual>
Query Return:
AUTO|MAN
Default Value:
AUTO
:TRACe:RECord:INTerval:TIME <numeric_value> {PS | NS | US | MS | S | MIN | HR}
:TRACe:RECord:INTerval:TIME?
Title:
Trace Recording Interval Time
Description:
This command sets or queries the interval length for use with manual interval mode Trace Recording.
Parameter(s):
<numeric_value> {PS | NS | US | MS | S | MIN | HR}
Query Return:
Numeric (ms)
Default Value:
10000 ms
Default Unit:
ms
Range:
20 ms to 3600000 ms
:TRACe:RECord:MODE <AUTO|TIMed>
:TRACe:RECord:MODE?
Title:
Trace Recording Mode
Description:
This command sets or queries the Trace Recording mode, AUTO or TIMed. AUTO mode means recording will continue indefinitely. TIMed mode means recording will last for the specified recording time set by the Trace Recording Time setting.
Parameter(s):
<AUTO|TIMed>
Query Return:
AUTO|TIM
Default Value:
AUTO
:TRACe:RECord:TAG
Title:
Trace Recording Add Tag
Description:
This command adds a tag to the current trace as it is being recorded or played.
:TRACe:RECord:TIME <numeric_value> {PS | NS | US | MS | S | MIN | HR}
:TRACe:RECord:TIME?
Title:
Trace Recording Time
Description:
This command sets or queries the amount of time to record for if the Trace Recording mode is TIMed.
Parameter(s):
<numeric_value> {PS | NS | US | MS | S | MIN | HR}
Query Return:
Numeric (ms)
Default Value:
20000 ms
Default Unit:
ms
Range:
1000 ms to 1000000000 ms
:TRACe:SELect <numeric_value>
:TRACe:SELect?
Title:
Select Trace
Description:
The selected trace will be used by operations that use a single trace. The max number of traces available to select is model specific.
To display the trace, see TRACe<n>:DISPlay[:STATe]
To update the trace state, see TRACe<n>:UPDate[:STATe]
Parameter(s):
<numeric_value>
Query Return:
Numeric
Default Value:
1
Range:
1 to 6
:TRACe:SPECtrogram:DETector[:FUNCtion] <POSitive|RMS|NEGative|SAMPle>
:TRACe:SPECtrogram:DETector[:FUNCtion]?
Title:
Spectrogram Detector Type
Description:
Sets the detection method for the spectrogram trace. 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. SAMPle detection selects one of the associated measurement points to display. This command will be ignored when spectrogram is disabled by DISPlay:VIEW. In RTSA mode the SAMPle detection replaces RMS detection.
Parameter(s):
<POSitive|RMS|NEGative|SAMPle>
Query Return:
POS|RMS|NEG|SAMP
Default Value:
POSitive
:TRACe:SPECtrogram:TYPE <NORMal|MINimum|MAXimum|AVERage|RMAXimum|RMINimum|RAVerage>
:TRACe:SPECtrogram:TYPE?
Title:
Spectrogram Trace Type
Description:
Specifies how successive sweeps are combined to produce the resulting display value. 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. This command will be ignored when spectrogram is disabled by DISPlay:VIEW.
Parameter(s):
<NORMal|MINimum|MAXimum|AVERage|RMAXimum|RMINimum|RAVerage>
Query Return:
NORM|MIN|MAX|AVER|RMAX|RMIN|RAV
Default Value:
NORMal
: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:
OkStatus = 0x0
ADCOverrange = 0x1
Saturation = 0x2
SLOLockFailure = 0x4
LO1LockFailure = 0x8
LO2LockFailure = 0x10
TGLOLockFailure = 0x20
LimitFailure = 0x40
OverpowerFailure = 0x1000
DeviceAccessFailure = 0x10000 Failed to communicate with the device.
EPROMFailure = 0x20000 Failed to access device EEPROM.
DataTransIrregular = 0x40000 Data transfer irregular.
NoCalibration = 0x80000 Data is not calibrated.
Parameter(s):
<numeric_value>
:TRIGger:GATE:SLOPe <POSitive|NEGative>
:TRIGger:GATE:SLOPe?
Title:
Gated Sweep Trigger Slope
Description:
The gate trigger slope indicates whether the trigger point is on the rising or the falling edge of the external trigger signal.
Parameter(s):
<POSitive|NEGative>
Query Return:
POS|NEG
Default Value:
POSitive
:TRIGger[:SEQuence]:ATRigger <numeric_value> {PS | NS | US | MS | S | MIN | HR}
:TRIGger[:SEQuence]:ATRigger?
Title:
Trigger Auto Period
Description:
The trigger auto period is the amount of time that must pass without an trigger event before a measurement is triggered automatically.
Parameter(s):
<numeric_value> {PS | NS | US | MS | S | MIN | HR}
Query Return:
Numeric (ms)
Default Value:
1000 ms
Default Unit:
ms
Range:
0.001 ms to 5000 ms
:TRIGger[:SEQuence]:ATRigger:STATe <0 | 1 | ON | OFF>
:TRIGger[:SEQuence]:ATRigger:STATe?
Title:
Trigger Auto State
Description:
The trigger auto state indicates whether or not a measurement should be triggered automatically after the Trigger Auto Period elapses.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
:TRIGger[:SEQuence]:DELay <numeric_value> {PS | NS | US | MS | S | MIN | HR}
:TRIGger[:SEQuence]:DELay?
Title:
Trigger Delay
Description:
The trigger delay is the amount of time between when an external trigger event happens and when the measurement starts.
Parameter(s):
<numeric_value> {PS | NS | US | MS | S | MIN | HR}
Query Return:
Numeric (ms)
Default Value:
0 ms
Default Unit:
ms
Range:
-1000 ms to 1670 ms
:TRIGger[:SEQuence]:DELay:STATe <0 | 1 | ON | OFF>
:TRIGger[:SEQuence]:DELay:STATe?
Title:
Trigger Delay State
Description:
The trigger delay state turns trigger delay on/off.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
:TRIGger[:SEQuence]:HOLDoff <numeric_value> {PS | NS | US | MS | S | MIN | HR}
:TRIGger[:SEQuence]:HOLDoff?
Title:
Trigger Holdoff
Description:
The trigger holdoff is the amount of time between when a measurement ends and when to start looking for the next external trigger event.
Parameter(s):
<numeric_value> {PS | NS | US | MS | S | MIN | HR}
Query Return:
Numeric (ms)
Default Value:
0 ms
Default Unit:
ms
Range:
0 ms to 5000 ms
:TRIGger[:SEQuence]:HOLDoff:STATe <0 | 1 | ON | OFF>
:TRIGger[:SEQuence]:HOLDoff:STATe?
Title:
Trigger Holdoff State
Description:
The trigger holdoff state turns trigger holdoff on/off.
Parameter(s):
<0 | 1 | ON | OFF>
Query Return:
0 | 1
Default Value:
OFF
:TRIGger[:SEQuence]:PORT<n>[:DIRection] <IN|OUT>
:TRIGger[:SEQuence]:PORT<n>[:DIRection]?
Title:
Trigger Port Direction
Description:
This command configures the direction of the trigger ports, which can behave as either trigger in or trigger out. The command suffix selects which of the two trigger ports to configure. Note that port 1 doubles as a reference out port and cannot be a reference out and trigger port at the same time. To use port one as a trigger port the reference output state must be turned off (see the 10MHz Reference Output State) command.
Parameter(s):
<IN|OUT>
PORT Suffix Range:
1-2, Default = 1
:TRIGger[:SEQuence]:SLOPe <POSitive|NEGative>
:TRIGger[:SEQuence]:SLOPe?
Title:
Trigger Slope
Description:
The trigger slope indicates whether the trigger point is on the rising or the falling edge of the external trigger signal.
Parameter(s):
<POSitive|NEGative>
Query Return:
POS|NEG
Default Value:
POSitive
:TRIGger[:SEQuence]:SOURce <EXT1|EXT2|IMMediate|VIDeo>
:TRIGger[:SEQuence]:SOURce?
Title:
Trigger Source
Description:
The trigger source indicates whether or not to look for a trigger condition before making measurements.
IMMediate trigger source means that sweeps will be triggered without looking for a trigger event (free-run). VIDeo trigger is only valid for zero span and IQ capture. Video trigger is not supported for IQ streaming. External trigger options with a suffix number in them are only available on instruments with more than one trigger port and in this case omitting the number will be the same as using EXT1. For products that support trigger port direction settings, the ports will only be available as trigger sources if the trigger direction for that port is set to IN.
Parameter(s):
<EXT1|EXT2|IMMediate|VIDeo>
Query Return:
EXT1|EXT2|IMM|VID
Default Value:
IMMediate
:TRIGger[:SEQuence]:VIDeo:HYSTeresis <numeric_value> {DB}
:TRIGger[:SEQuence]:VIDeo:HYSTeresis?
Title:
Trigger Video Hysteresis
Description:
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.
Parameter(s):
<numeric_value> {DB}
Query Return:
Numeric (dB)
Default Value:
0 dB
Default Unit:
dB
Range:
0 dB to 200 dB
:TRIGger[:SEQuence]:VIDeo:LEVel <numeric_value> {<amplitude_units>}
:TRIGger[:SEQuence]:VIDeo:LEVel?
Title:
Trigger Video Level
Description:
The amplitude value which the input signal must cross for a trigger event to occur when trigger source is video (TRIG:SOUR VID).
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
:UNIT:CHPower:PSDensity <HZ|MHZ>
:UNIT:CHPower:PSDensity?
Title:
Power Spectral Density Units
Description:
Sets the power spectral density units to the current amplitude per either Hz or MHz. For example, if the current amplitude unit is dBm, then Hz would refer to dBm/Hz, and MHZ would be refer to dBm/MHz.
Parameters DB/MHz and DBM/MHz have been deprecated, but are still accepted values.
Parameter(s):
<HZ|MHZ>
Query Return:
HZ|MHZ
Default Value:
HZ
:UNIT:POWer <DBM|DBM/M2|DBW|DBW/M2|DBV|DBV/M|DBMV|DBMV/M|DBUV|DBUV/M|DBA|DBA/M|V|V/M|A|A/M|W|W/M2|W/CM2>
:UNIT:POWer?
Title:
Measurement Units
Description:
Sets the default amplitude units for input, output and display.
<MS27201A>
The following units are only available when Field Strength is ON: DBM/M2, DBW/M2, DBV/M, DBMV/M, DBUV/M, DBA/M, V/M, A/M, W/M2, W/CM2
To query or set the Field Strength state, use [:SENSe]:FSTRength:STATe
Parameter(s):
<DBM|DBM/M2|DBW|DBW/M2|DBV|DBV/M|DBMV|DBMV/M|DBUV|DBUV/M|DBA|DBA/M|V|V/M|A|A/M|W|W/M2|W/CM2>
Query Return:
DBM|DBMM2|DBW|DBWM2|DBV|DBVM|DBMV|DBMVM|DBUV|DBUVM|DBA|DBAM|V|VM|A|AM|W|WM2|WCM2
Default Value:
DBM
2021-11-16T05:01:33PM