NI Bluetooth Analysis Toolkit

niBT RFSA Read Power Spectrum VI

  • Updated2023-02-21
  • 3 minute(s) read

Initiates a spectrum acquisition for one or more channels and returns the averaged power spectrum data. You can initiate this acquisition by transitioning the signal from idle state to active state.

niBT RFSA Read Power Spectrum

crn.gif

niBT SA session specifies the niBT SA session refnum. Use this parameter to configure the behavior and operation of the appropriate NI Bluetooth Analysis Toolkit VI that accepts the niBT SA session refnum at its input.

cio.gif

instrument handle identifies the instrument session. The toolkit obtains this parameter from the niRFSA Initialize VI or the niRFSA Initialize With Options VI.

cdbl.gif

timeout specifies the time allotted for the VI to complete before returning a timeout error. This value is expressed in seconds. A value of –1 specifies that the VI waits until all data is available. A value of 0 specifies that the VI returns the available data immediately. The default value is 10.

cerrcodeclst.gif

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

irn.gif

niBT SA session out returns the niBT SA session refnum. Use this reference as the session input to subsequent VIs.

Note  Close the niBT SA session refnum using the niBT SA Close Session VI before the VI completes execution to avoid possible memory leak issues.
iio.gif

instrument handle out passes a reference from the instrument session to the next VI.

icclst.gif

power spectrum returns the real-valued power spectrum.

idbl.gif

f0 returns the start frequency of the spectrum. This value is expressed in Hz.

idbl.gif

df returns the frequency interval between data points in the spectrum. This value is expressed in Hz.

i1dcdb.gif

y returns the averaged power spectrum acquired using NI-RFSA.

ierrcodeclst.gif

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

Log in to get a better experience