BTS Master Programming Manual : TD‑LTE Commands : :READ Subsystem
 
:READ Subsystem
This set of commands combines the ABORt, INITiate and FETCh commands. It aborts any current triggering sequence and sets the trigger state to idle. It then initiates a new active measurement (i.e., begins the collection of new data). When the measurement is complete, it returns the results. These commands will not switch to another measurement.
To get the current measurement data, use the FETCh command.
:READ:DEMod:CONStln?
Title
Read 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
:READ:DEMod:TIMEalign?
Title
Read Tx Time Alignment Data
Description
Triggers a new Time Alignment measurement and returns the results. The Tx Time Alignment measurement must be the active measurement (specified by :CONFigure:DEMod TIMEalign). The current measurement can be queried using the command :CONFigure?
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
:READ:OTA:CAGGregation?
Title
Read OTA Carrier Aggregation
Description
Triggers a new Carrier Aggregation measurement and returns the results. The Carrier Aggregation measurement must be the active measurement (specified by :CONFigure:DEMod CAGGregation). The current measurement can be queried using the command :CONFigure?.
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
:READ:OTA:MAPping?
Title
Read OTA Coverage Mapping
Description
Triggers a new OTA Coverage Mapping measurement and returns the results. The OTA Mapping measurement must be the active measurement (specified by :CONFigure:OTA MAPping). The current measurement can be queried using the command :CONFigure?
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.
Default Unit
dBm
Front Panel Access
Measurements, Over‑the‑Air, Mapping
:READ:OTA:SCANner?
Title
Read OTA Scanner
Description
Triggers a new OTA Scanner measurement and returns the results. The OTA Scanner measurement must be the active measurement (specified by :CONFigure:OTA SCANner). The current measurement can be queried using the command :CONFigure?
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
:READ:OTA:TXTEst?
Title
Read OTA Tx Test
Description
Triggers a new OTA Tx Test measurement and returns the results. The OTA Tx Test measurement must be the active measurement (specified by :CONFigure:OTA Tx Test). The current measurement can be queried using the command :CONFigure?
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.
Default Unit
dBm
Front Panel Access
Measurements, Over‑the‑Air, Tx Test
:READ:PFail?
Title
Read PASS/FAIL
Description
Triggers a new PASS/FAIL measurement and returns the results. It is a combination of the commands :ABORT, :INITiate, and FETCh:PFail? The PASS/FAIL measurement must be active. The current measurement can be queried using :CONFigure?
Related Command
:FETCh:PFail?
:CONFigure PFail
:MEASure:PFail?
Front Panel Access
Measurements, Pass/Fail Test
:READ:RF:ACLR?
Title
Read Adjacent Channel Leakage Ratio
Description
Triggers a new Adjacent Channel Leakage Ratio measurement and returns the results: Power levels for each channel (both absolute and relative). 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 11 comma‑separated values: Main channel power, Left alternate channel power - relative, absolute, Left adjacent channel power - relative, absolute, Main channel power - relative, absolute, Right adjacent channel power - relative, absolute, Right Alternate channel power - relative, absolute.
Default Unit
dBm
Front Panel Access
Measurements, RF, ACLR
:READ:RF:PVTime?
Title
Read Power vs. Time
Description
Triggers a new Power vs. Time measurement and returns the 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. It is a combination of the commands :ABORT; :INITiate; :FETCh:RF:PVTime?
The Power vs. Time measurement must be the active measurement (specified by :CONFigure:RF PVTime). The current measurement can be queried using :CONFigure?
Related Command
:FETCh:RF:PVTime?
:CONFigure:RF PVTime
Front Panel Access
Measurements, RF, Power vs. Time
:READ:RF:SEM?
Title
Read RF Spectral Emission Mask
Description
Triggers a new RF Spectral Emission Mask measurement and returns a PASS or FAIL result. It is a combination of the commands :ABORT, :INITiate, and FETCh:RF:SEM? The current measurement can be queried using :CONFigure?
Front Panel Access
Measurements, RF, Spectral Emission Mask
:READ:RF:SPECtrum?
Title
Read RF Spectrum
Description
Triggers a new RF Spectrum measurement and returns the results: Channel Power and Occupied BW measurement. It is a combination of the commands :ABORT, :INITiate, and FETCh:RF:SPECtrum? The current measurement can be queried using :CONFigure?
Data is returned as 2 comma‑delimited values: Channel Power(RSSI) in dBm and Occupied bandwidth measurement in MHz.
Related Command
:FETCh:RF:SPECtrum?
:CONFigure:RF SPECtrum
:MEASure:RF:SPECtrum?
Front Panel Access
Measurements, RF, Channel Spectrum