NI Bluetooth Analysis Toolkit

niBTSA_RFSAMeasure

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

int32 __stdcall niBTSA_RFSAMeasure (niBTSASession session, ViSession RFSAHandle, char hwChannelString[], double timeout);

Purpose

Configures the NI RF vector signal analyzer and initiates acquisition on the hardware. This function then fetches the waveforms and calls the niBTSA_AnalyzePowerSpectrum function in a loop n times to perform measurements on the acquired waveforms, where n is equal to the number of averages specified.

Parameters

Input
Name Type Description
session niBTSASession Specifies the niBT SA session. Use this parameter to configure the behavior and operation of the appropriate NI Bluetooth Analysis Toolkit function that accepts the niBTSASession as an input.
RFSAHandle ViSession Identifies the instrument session. The toolkit obtains this parameter from the niRFSG_init function or the niRFSG_InitWithOptions function.
hwChannelString char[] Specifies the NI RF vector signal analyzer device channel. Set this parameter to "" (empty string) or NULL.
timeout double Specifies the time, in seconds, allotted for the function to complete before returning a timeout error. A value of -1 specifies that the function waits until all data is available. A value of 0 specifies that the niBTSA_RFSAMeasure function returns the available data immediately. The default value is 10.

Return Value

Name Type Description
status int32 Returns the status code of this operation. The status code either indicates success or describes an error or warning. Examine the status code from each call to an niBT SA function to determine if an error has occurred.

To obtain a text description of the status code and additional information about the error condition, call the niBTSA_GetErrorString function.

The general meaning of the status code is as follows:

Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

Log in to get a better experience