RFmx LTE VIs

Table of Contents

RFmxLTE OBW Fetch (VI)

  • Updated2024-04-10
  • 5 minute(s) read

RFmxLTE OBW Fetch (VI)

Owning Palette: Fetch

Fetches the OBW measurements.

RFmxLTE OBW Fetch Measurement

Returns the occupied bandwidth, absolute power, start frequency, and stop frequency of a component carrier or subblock.

Use "subblock<n>" as the selector string to read results from this VI.

Refer to the LTE Occupied Bandwidth topic for more information about OBW measurements.

RFmxLTE OBW Fetch Measurement

cio.gif

Instrument Handle In specifies the RFmx session refnum. Instrument Handle In is obtained from the RFmxInstr Initialize NIRFSA VI.

cdbl.gif

Timeout specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the VI waits until the measurement is complete. The default value is 10.

cstr.gif

Selector String specifies a selector string comprising of the signal name, result name, and subblock number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used. The default value is "subblock0".

Example:

"subblock0"

"signal::sig1/subblock0"

"result::r1/subblock0"

"signal::sig1/result::r1/subblock0"

You can use the RFmxLTE Build Subblock String VI to build the selector string.

cerrcodeclst.gif

error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

iio.gif

Instrument Handle Out passes a reference to your RFmx session to the next VI.

idbl.gif

Occupied Bandwidth returns the bandwidth that occupies 99 percentage of the total power of the signal within a carrier/subblock.

idbl.gif

Absolute Power returns the power measured over the integration bandwidth of the carrier. The carrier power is reported in dBm when you set the ACP Pwr Units property to dBm, and in dBm/Hz when you set the ACP Pwr Units property to dBm/Hz.

idbl.gif

Stop Frequency returns the stop frequency of the subblock. The occupied bandwidth of a carrier/subblock is calculated using the following equation:

Stop frequency - Start frequency = Occupied bandwidth.

idbl.gif

Start Frequency returns the start frequency of the subblock. The occupied bandwidth of a carrier/subblock is calculated using the following equation:

Stop frequency - Start frequency = Occupied bandwidth.

ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

RFmxLTE OBW Fetch Spectrum

Fetches the spectrum used for OBW measurements.

RFmxLTE OBW Fetch Spectrum

cio.gif

Instrument Handle In specifies the RFmx session refnum. Instrument Handle In is obtained from the RFmxInstr Initialize NIRFSA VI.

cdbl.gif

Timeout specifies the timeout for fetching the specified measurement. This value is expressed in seconds. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the VI waits until the measurement is complete. The default value is 10.

cstr.gif

Selector String specifies a selector string comprising of the signal name and the result name. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used. The default value is "" (empty string).

Example:

"signal::sig1"

"result::r1"

"signal::sig1/result::r1"

You can use the RFmxLTE Build Signal String VI to build the selector string.

cerrcodeclst.gif

error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

iio.gif

Instrument Handle Out passes a reference to your RFmx session to the next VI.

icclst.gif

Spectrum returns the spectrum.

idbl.gif

x0 returns the start frequency of the channel. This value is expressed in Hz.

idbl.gif

dx returns the frequency bin spacing. This value is expressed in Hz.

i1dsgl.gif

y returns the array of averaged power measured at each frequency bin. This value is expressed in dBm.

ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

Log in to get a better experience