S331E, S332E, S361E, S362E Site Master™MS2711E, MS2712E, MS2713E Spectrum Master™MT8212E, MT8213E Cell Master™ Programming Manual : LTE Commands : :FETCh Subsystem
 
:FETCh Subsystem
This set of commands returns the most recent measurement data of the active measurement. They turnsnot switch to another measurement.
To make a new measurement, use the INITiate command. To get new measurement data, use the READ or MEASure query commands.
:FETCh:DEMod:4x4:TIMEalign?
Title
Fetch Tx Time Alignment Data (4x4 MIMO configuration)
Description
Returns the most recent Time Alignment measurement numeric results. 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 :FETCh:DEMod:TIMEalign? command, instead. Refer to your instrument User Guide for instructions on updating firmware.
Data are 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
:FETCh:DEMod:CCPData?
Title
Fetch Control Power Data
Description
Returns the most recent Control Channel Power measurement numeric results.
Data are returned as 24 comma‑delimited 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
Front Panel Access
Measurements, Modulation, Control Channel Power
:FETCh:DEMod:CONStln?
Title
Fetch Constellation
Description
Returns the constellation measurement numeric results of the demodulated data symbol over one sub‑frame measurement.
Data are 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
:FETCh:DEMod:PVRB?
Title
Fetch Power vs Resource Block Data
Description
Returns the PVRB measurement results of the demodulated data.
Data are returned as a string of comma‑delimited values: Active RBs, Utilization in %, Channel Power in dBm, OSTP (OFDM Symbol Transmit Power) in dBm, EVM total in %, EVM (QPSK) in %, EVM (16‑QAM) in %, EVM (64‑QAM) in %, Cell ID.
If Option 886 is installed and activated on the instrument, a value for EVM (256‑QAM) in % is returned at the end of the PVRB data string. “--” is returned if the LTE carrier does not use 256‑QAM modulation scheme. This value does not immediately follow EVM (64‑QAM) in order to maintain backward compatibility with instruments where Option 886 is not installed.
Front Panel Access
Measurements, Modulation, Power vs Resource Block
:FETCh:DEMod:TIMEalign?
Title
Fetch Tx Time Alignment Data
Description
Returns the most recent Time Alignment measurement numeric results.
Data are returned as nine 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
:FETCh:OTA:C4AGGregation?
Title
Fetch OTA Carrier Aggregation (4x4 MIMO configuration)
Description
Returns the result of the most recent Carrier Aggregation measurement numeric results. 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 :FETCh:OTA:CAGGregation? command, instead. Refer to your instrument User Guide for instructions on updating firmware.
Data are returned as 70 comma delimited values. The values consist of five 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 are in sequential CC order.
A field with “--” means the data was invalid. An inactive Component Carrier turnsshow N/A for the entire set of data.
Front Panel Access
Measurements, Over‑the‑Air, Carrier Aggregation
:FETCh:OTA:CAGGregation?
Title
Fetch OTA Carrier Aggregation
Description
Returns the result of the most recent Carrier Aggregation measurement numeric results. Data are returned as 60 comma delimited values.
The values consist of five 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 are in sequential CC order.
A field with “--” means the data was invalid. An inactive Component Carrier turnsshow N/A for the entire set of data.
Front Panel Access
Measurements, Over‑the‑Air, Carrier Aggregation
:FETCh:OTA:MAPping?
Title
Fetch OTA Coverage Mapping
Description
Returns the most recent Coverage Mapping measurement results.
Data are 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 are a final value for the Dominance.
“‑‑” is returned for each data that is not valid at that instance.
Front Panel Access
Measurements, Over‑the‑Air, Mapping
:FETCh:OTA:SCANner?
Title
Fetch OTA Scanner
Description
Returns the most recent OTA Scanner measurement results.
Data are 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 are a final value for the Dominance.
“‑‑” is returned for each data that is not valid at that instance.
Front Panel Access
Measurements, Over‑the‑Air, Scanner
:FETCh:OTA:TXTEst?
Title
Fetch OTA Tx Test
Description
Returns the most recent OTA Tx Text measurement results.
Data are 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 are an additional set of four numbers: Dominance, Antenna Count, Average Power, Delta Power.
“‑‑” is returned for each data that is not valid at that instance.
Front Panel Access
Measurements, Over‑the‑Air, Tx Test
:FETCh:RF:ACLR?
Title
Fetch Adjacent Channel Leakage Ratio
Description
Returns the most recent adjacent channel leakage ratio measurement results. If the instrument is sweeping, it turnsnot return until the sweep is complete. Refer to :READ:RF:ACLR? for a description of the returned data.
Default Unit
dBm
Front Panel Access
Measurements, RF, ACLR
:FETCh:RF:SEM?
Title
Fetch Spectral Emission Mask
Description
Returns Spectral Emission Mask measurement results (Pass or Fail).
Front Panel Access
Measurements, RF, Spectral Emission Mask
:FETCh:RF:SPECtrum?
Title
Fetch RF Spectrum
Description
Returns the most recent RF Spectrum measurement results. Data are returned as two comma‑delimited values: Channel Power in dBm and Occupied bandwidth measurement in MHz. “--” is returned for each data that is not valid at that instance.
Front Panel Access
Measurements, RF, Channel Spectrum
:FETCh:SUMMary?
Title
Fetch Summary
Description
Returns the values displayed in a Summary measurement view. If the current display is not a summary screen, the return value is ‘N/A’. The return string is a comma-separated list of the values displayed on the screen, in the order they are listed from top to bottom. The list is preceded by the name of the summary view: “RF Summary,” “Modulation Summary,” or “LTE Summary”.
RF Summary, Channel Power in dBm, Occupied BW in MHz, Lower Adjacent Channel Power 2 in dBm, Lower Adjacent Channel Power 1 in dBm, Upper Adjacent Channel Power 1 in dBm, Upper Adjacent Channel Power 2 in dBm, Spectral Emission Mask (Pass or Fail).
Modulation Summary, Ref Signal (RS) Power in dBm, Sync Signal (SS) Power in dBm, EVM (rms) in %, EVM (QPSK) in %, EVM (16‑QAM) in %, EVM (64‑QAM) in %, Freq Error in Hz, Freq Error in ppm, Cell ID, PBCH Power in dBm.
If Option 886 is activated on the instrument, a value for EVM (256‑QAM) in % is returned at the end of the Modulation Summary data string. “--” is returned if the LTE carrier does not use 256‑QAM modulation scheme. This value does not immediately follow EVM (64‑QAM) in order to maintain backward compatibility with instruments where Option 886 is not installed.
LTE Summary, Freq Error in Hz, Occupied BW in MHz, Carrier Frequency in MHz, Channel Power in dBm, Ref Signal (RS) Power in dBm, Sync Signal (SS) Power in dBm, EVM (rms) in %, PBCH Power in dBm, PCFICH Power in dBm, Spectral Emission Mask (Pass or Fail).
When Option 886 is installed, 256‑QAM EVM measurement results are included in the calculation of EVM (rms) percentage value.
Front Panel Access
Measurements, RF, RF Summary
Measurements, Modulation, Modulation Summary
Measurements, LTE Summary