Spectrum Master Programming Manual : TD‑LTE Commands : :FETCh Subsystem
 
:FETCh Subsystem
This set of commands returns the most recent measurement data of the active measurement. They will not 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:CCPData?
Title
Fetch Demodulator Code Domain Power Data
Description
Returns the most recent Control Channel Power measurement numeric results.
Data is 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 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
:FETCh:DEMod:PVRB?
Title
Fetch Power vs Resource Block Data
Description
Returns the PVRB measurement results of the demodulated data.
Data is 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 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
:FETCh:OTA:CAGGregation?
Title
Fetch OTA Carrier Aggregation
Description
Returns the result of the most recent Carrier Aggregation measurement numeric results. 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, CC#
:FETCh:OTA:MAPping?
Title
Fetch OTA Coverage Mapping
Description
Returns the most recent Coverage Mapping measurement results.
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.
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 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.
Front Panel Access
Measurements, Over‑the‑Air, Scanner
:FETCh:OTA:TXTEst?
Title
Fetch OTA Tx Test
Description
Returns the most recent OTA Tx Test measurement results.
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 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 will not 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:PVTime?
Title
Fetch Power vs. Time
Description
Returns Power vs. Time measurement results – Total Frame Power, DwPTS Power, Transmit Off Power, Cell ID, Timing Error, Sub‑Frame Power 1, 2, ...10. “‑‑” is returned for each data that is not valid at that instance.
Front Panel Access
Measurements, RF, Power vs. Time
: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 is returned as 2 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 “TD‑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), Total Frame Power in dBm, DwPTS (Downlink Pilot Time Slot) Power in dBm, Transmit Off Power in dBm, Timing Error.
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.
TD‑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, TD-LTE Summary