niWLANA_GetCurrentIterationOFDMDemodChannelFrequencyResponseTrace

NI WLAN Analysis Toolkit 18.0 Help

Edition Date: October 2018

Part Number: 373724K-01

»View Product Info
Download Help (Windows Only)

int32 __stdcall niWLANA_GetCurrentIterationOFDMDemodChannelFrequencyResponseTrace (niWLANAnalysisSession session, char channelString[], int32 index[], float64 CFRMagnitude[], float64 CFRPhase[], int32 dataArraySize, int32 *actualArraySize);

Purpose

Returns the channel frequency response magnitude and phase for each subcarrier in each iteration when the toolkit processes the acquired burst. The portion of the signal that the toolkit uses to obtain this trace is specified by the NIWLANA_OFDM_DEMOD_CHANNEL_ESTIMATION_METHOD attribute.

To use this function, you must set the NIWLANA_OFDM_DEMOD_ENABLED and NIWLANA_OFDM_DEMOD_CHANNEL_FREQUENCY_RESPONSE_TRACE_ENABLED attributes to NIWLANA_VAL_TRUE.

You must use the following active channel string formats to query this function.

NIWLANA_STANDARD attribute setting NIWLANA_OFDM_DEMOD_COMBINED_SIGNAL_DEMODULATION_ENABLED attribute Active channel string syntax
NIWLANA_VAL_STANDARD_80211AG_OFDM, NIWLANA_VAL_STANDARD_80211J_OFDM, NIWLANA_VAL_STANDARD_80211P_OFDM, NIWLANA_VAL_STANDARD_80211G_DSSS_OFDM N.A. "" (empty string)
NIWLANA_VAL_STANDARD_80211N_MIMO_OFDM NIWLANA_VAL_FALSE "channelx/streamy"
NIWLANA_VAL_TRUE "streamy"
NIWLANA_VAL_STANDARD_80211AC_MIMO_OFDM, NIWLANA_VAL_STANDARD_80211AX_MIMO_OFDM NIWLANA_VAL_FALSE "[segmentx/]channely/streamz" ("segment0/" is optional if the NIWLANA_NUMBER_OF_SEGMENTS attribute is set to 1.)
NIWLANA_VAL_TRUE "[segmentx/]streamz" ("segment0/" is optional if the NIWLANA_NUMBER_OF_SEGMENTS attribute is set to 1.)
NIWLANA_VAL_STANDARD_80211AH_MIMO_OFDM "channelx/streamy"
NIWLANA_VAL_STANDARD_80211AF_MIMO_OFDM "[segmentx]/channely/streamz" ("segment0/" is optional if the NIWLANA_NUMBER_OF_SEGMENTS attribute is set to 1.)

Parameters

Input
Name Type Description
session niWLANAnalysisSession Specifies the niWLAN analysis session refnum.
channelString char[] Specifies the active channel string.
dataArraySize int32 Specifies the number of elements in the data array.
Output
Name Type Description
index int32[] Returns the indices of the subcarriers.
CFRMagnitude float64[] Returns the magnitude of the channel frequency response. This value is expressed in dB.
CFRPhase float64[] Returns the phase of the channel frequency response. This value is expressed in radians.
actualArraySize int32* Returns the number of elements in the CFRMagnitude and CFRPhase arrays. If the arrays are not large enough to hold all the samples, the function returns an error and this parameter returns the minimum expected size of the output arrays.

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 condition. Examine the status code from each call to an niWLAN 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 niWLANA_GetErrorString function.

The general meaning of the status code is as follows:

Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

WAS THIS ARTICLE HELPFUL?

Not Helpful