Spectrum Master Programming Manual : LTE Commands : :MEASure Subsystem
 
:MEASure Subsystem
These commands take the instrument from its current state, enable the specified measurement and put the instrument into single sweep mode. They correct any parameters that are invalid given the new measurement state such that a valid measurement can take place. Other settings may be changed. Refer to the documentation of CONFigure for each measurement. They then initiate the measurement. When the measurement is complete, they return the result.
To make a measurement with settings other than the “default” measurement settings applied by CONFigure, do the following:
Send the appropriate CONFigure command to set the desired measurement.
Modify the settings as required.
Send the appropriate READ command to measure and return the result.
To get the current measurement data, use the appropriate FETCh command.
:MEASure:DEMod:4x4:TIMEalign?
Title
Measure Tx Time Alignment Data (4x4 MIMO configuration)
Description
Sets the active measurement to Tx Time Alignment, sets the default measurement parameters, triggers a new measurement, and returns the measured values. This command may not be supported if your instrument is loaded with older firmware, in which case you may upgrade to the current firmware version or use the :MEASure:DEMod:TIMEalign? command, instead. Refer to your instrument User Guide for instructions on updating firmware.
Data is returned as 14 comma‑delimited values: EVM (rms) in %, EVM (pk) in %, Ref Signal (RS) Power in dBm, Sync Signal (SS) Power in dBm, Carrier Frequency in MHz, Freq Error in Hz, Freq Error in ppm, Cell ID, and Time Alignment Error (TAE) in nanoseconds for each of antenna pairs 1-2, 1-3, 1-4, 2-3, 2-4, and 3-4. “--” is returned for each data that is not valid at that instance.
Front Panel Access
Measurements, Modulation, Tx Time Alignment
:MEAsure:DEMod:AVErage?
Title
Measure Constellation with Frequency Error Averaging
Description
Triggers a series of new Constellation measurements and returns the results. The number of measurements is set by the [:SENSe]AVErage:FERRor:COUNt n command.
Although ‘n’ measurements are taken, only a single result string returns. This will be the measured results of the last measurement in the set, except for frequency error, which is averaged over the entire ‘n’ measurements.
Note: If n is large, then an appropriately large value for the time‑out of the SCPI interface is required.
Data is returned as 9 comma‑delimited values: EVM (rms) in %, EVM (pk) in %, Ref Signal (RS) Power in dBm, Sync Signal (SS) Power in dBm, Carrier Frequency in MHz, Freq Error in Hz, Freq Error in ppm, the Cell ID, and the number of measurements average for Frequency Error. “‑‑” is returned for each data that is not valid at that instance.
Front Panel Access
Measurements, Modulation, Constellation
:MEASure:DEMod:CCPData?
Title
Read Modulation Control Channel Power Data
Description
Sets the active measurement to Control Channel Power, sets the default measurement parameters, triggers a new measurement, and returns the measured values:
RS_POWER, PSS_POWER, SSS_POWER, BCH_POWER, CFI_POWER, RS_TOTAL_POWER, PSS_TOTAL_POWER, SSS_TOTAL_POWER, BCH_TOTAL_POWER, CFI_TOTAL_POWER, TOTAL_POWER, TOTAL_CHANNEL_POWER.
Data returned is the same for Bar Graph or Table mode. The Control Channel Power measurement must be the active measurement.
Front Panel Access
Measurements, Modulation, Control Channel Power
:MEASure:DEMod:CONStln?
Title
Measure Constellation
Description
Triggers a new Constellation measurement and returns the results. The Constellation measurement must be the active measurement (specified by :CONFigure:DEMod CONStln). The current measurement can be queried using the command :CONFigure?
Data is returned as 10 comma‑delimited values: EVM (rms) in %, EVM (pk) in %, Ref Signal (RS) Power in dBm, Sync Signal (SS) Power in dBm, Carrier Frequency in MHz, Freq Error in Hz, Freq Error in ppm, Cell ID, the number of measurements used in the frequency error average (if on), and OSTP (OFDM Symbol Transmit Power) in dBm. “--” is returned for each data that is not valid at that instance.
Front Panel Access
Measurements, Modulation, Constellation
:MEASure:DEMod:TIMEalign?
Title
Measure Tx Time Alignment Data
Description
Sets the active measurement to Tx Time Alignment, sets the default measurement parameters, triggers a new measurement, and returns the measured values.
Data is returned as 9 comma‑delimited values: EVM (rms) in %, EVM (pk) in %, Ref Signal (RS) Power in dBm, Sync Signal (SS) Power in dBm, Carrier Frequency in MHz, Freq Error in Hz, Freq Error in ppm, Cell ID, and Time Alignment Error (TAE) in nanoseconds. “--” is returned for each data that is not valid at that instance.
Front Panel Access
Measurements, Modulation, Tx Time Alignment
:MEASure:OTA:C4AGGregation?
Title
Measure OTA Carrier Aggregation (4x4 MIMO configuration)
Description
Sets the active measurement to Carrier Aggregation, triggers a new measurement, and returns the measured values. This command may not be supported if your instrument is loaded with older firmware, in which case you may upgrade to the current firmware version or use the :MEASure:OTA:CAGGregation? command, instead. Refer to your instrument User Guide for instructions on updating firmware.
Data is returned as 70 comma delimited values. The values consist of 5 sets of Component Carrier (CC) data, with each set containing 14 fields (CP, tx1 antenna, tx2 antenna, tx3 antenna, tx4 antenna, RS Power, RS Delta Power, SS Power, EVM(rms), EVM(pk), Freq Error, Freq Error (ppm), TAE (nS), and Cell ID). The data is in sequential CC order. A field with “--“ means the data was invalid. An inactive Component Carrier will show N/A for the entire set of data.
Front Panel Access
Measurements, Over‑the‑Air, Carrier Aggregation
:MEASure:OTA:CAGGregation?
Title
Measure OTA Carrier Aggregation
Description
Sets the active measurement to Carrier Aggregation, triggers a new measurement, and returns the measured values.
Data is returned as 60 comma delimited values. The values consist of 5 sets of Component Carrier (CC) data, with each set containing 12 fields (CP, tx1 antenna, tx2 antenna, RS Power, RS Delta Power, SS Power, EVM(rms), EVM(PK), Freq Error, Freq Error (ppm), TAE (nS), and Cell ID). The data is in sequential CC order. A field with “--” means the data was invalid. An inactive Component Carrier will show N/A for the entire set of data.
Front Panel Access
Measurements, Over‑the‑Air, Carrier Aggregation
:MEASure:OTA:MAPping?
Title
Measure OTA Coverage Mapping
Description
Sets the active measurement to OTA Coverage Mapping, sets the default measurement parameters, triggers a new measurement, and returns the measured values.
Data is returned as six sets of comma‑delimited values. Each set consists of: Cell ID, Group ID, Sector ID, S‑SS Power, RSRP, RSRQ, and SINR.
Following the six sets of data is a final value for the Dominance. “‑‑” is returned for each data that is not valid at that instance.
Default Unit
dBm
Front Panel Access
Measurements, Over‑the‑Air, Mapping
:MEASure:OTA:MAPping:RUN STARt|STOP
:MEASure:OTA:MAPping:RUN?
Title
Coverage Mapping Data Collection
Description
Turns On/Off the coverage mapping data collection. The instrument must be in Mapping measurement mode for the command to be effective.
No data is returned.
Front Panel Access
Measurements, Over‑the‑Air, Mapping, Start/Stop Data Collection (Main menu key)
:MEASure:OTA:SCANner?
Title
Measure OTA Scanner
Description
Sets the active measurement to OTA Scanner, sets the default measurement parameters, triggers a new measurement, and returns the measured values.
Data is returned as six sets of comma‑delimited values. Each set consists of: Cell ID, Group ID, Sector ID, S‑SS Power, RSRP, RSRQ, and SINR.
Following the six sets of data is a final value for the Dominance. “‑‑” is returned for each data that is not valid at that instance.
Default Unit
dBm
Front Panel Access
Measurements, Over‑the‑Air, Scanner
:MEASure:OTA:TXTEst?
Title
Measure OTA Tx Test
Description
Sets the active measurement to OTA Tx Test, sets the default measurement parameters, triggers a new measurement, and returns the measured values.
Data is returned as three sets of comma‑delimited values. Each set consists of: Cell ID, Group ID, Sector ID, S‑SS Power, RSRP, RSRQ, and SINR.
Following the three sets of data is an additional set of four results: Dominance, Antenna count, Average Power, Delta Power.
“‑‑” is returned for each data that is not valid at that instance.
Default Unit
dBm
Front Panel Access
Measurements, Over‑the‑Air, Tx Test
:MEASure:RF:ACLR?
Title
Measure Adjacent Channel Leakage Ratio
Description
Sets the active measurement to adjacent channel power ratio, sets the default measurement parameters, triggers a new measurement and returns the main channel(s) power, and adjacent channel(s) power. It is a combination of the commands :CONFigure:RF ACLR and :READ:RF:ACLR? Refer to :READ:RF:ACLR? for a description of the returned data.
Default Unit
dBm
Front Panel Access
Measurements, RF, ACLR
:MEASure:RF:SEM?
Title
Measure Spectral Emission Mask
Description
Sets the active measurement to Spectral Emission Mask and returns a PASS or FAIL result.
Front Panel Access
Measurements, RF, Spectral Emission Mask
:MEASure:RF:SPECtrum?
Title
Measure RF Spectrum
Description
Sets the active measurement to Channel Spectrum, sets the default measurement parameters, triggers a new measurement and returns the Channel Power and Occupied Bandwidth measurement results. It is a combination of the following commands: :CONFigure:RF SPECtrum and :READ:RF:SPECtrum?.
Data is returned as 2 comma‑delimited values: Channel Power in dBm and Occupied bandwidth in MHz.
Front Panel Access
Measurements, RF, Channel Spectrum