niWLANA_GetCurrentIterationDecodedBitsTrace

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_GetCurrentIterationDecodedBitsTrace (niWLANAnalysisSession session, int32 decodedBits[], int32 dataArraySize, int32 *actualArraySize);

Purpose

Returns the sequence of bits obtained from the signal after demodulation and decoding for each iteration when the toolkit processes the acquired burst.

Note  The toolkit does not support decoding of received bits for direct sequence spread spectrum (DSSS) signals with a data rate of 33 Mbps, and the toolkit cannot return the decoded bits trace. The toolkit returns an error if you call this function after performing demodulation measurements on DSSS signals with a data rate of 33 Mbps.

If you set the NIWLANA_STANDARD attribute to NIWLANA_VAL_STANDARD_80211AG_OFDM, NIWLANA_VAL_STANDARD_80211J_OFDM, NIWLANA_VAL_STANDARD_80211P_OFDM, NIWLANA_VAL_STANDARD_80211G_DSSS_OFDM, NIWLANA_VAL_STANDARD_80211N_MIMO_OFDM, NIWLANA_VAL_STANDARD80211AC_MIMO_OFDM, or NIWLANA_VAL_STANDARD_80211AX_MIMO_OFDM, set the NIWLANA_OFDM_DEMOD_ENABLED and NIWLANA_OFDM_DEMOD_ALL_TRACES_ENABLED attributes to NIWLANA_VAL_TRUE, or set the NIWLANA_OFDM_DEMOD_DECODED_BITS_TRACE_ENABLED attribute to NIWLANA_VAL_TRUE to get the current iteration decoded bits trace.

If you set the NIWLANA_STANDARD attribute to NIWLANA_VAL_STANDARD_80211BG_DSSS, set the NIWLANA_DSSS_DEMOD_ENABLED and NIWLANA_DSSS_DEMOD_ALL_TRACES_ENABLED attributes to NIWLANA_VAL_TRUE, or set the NIWLANA_DSSS_DEMOD_DECODED_BITS_TRACE_ENABLED attribute to NIWLANA_VAL_TRUE to get the current iteration decoded bits trace.

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

NIWLANA_STANDARD NIWLANA_RESULT_OFDM_DEMOD_PPDU_TYPE Active channel string syntax
NIWLANA_VAL_STANDARD_80211AG_OFDM, NIWLANA_VAL_STANDARD_80211J_OFDM, NIWLANA_VAL_STANDARD_80211P_OFDM, NIWLANA_VAL_STANDARD_80211N_MIMO_OFDM N.A. "" (empty string)
NIWLANA_VAL_STANDARD_80211AC_MIMO_OFDM NIWLANA_VAL_OFDM_DEMOD_PPDU_TYPE_SU_PPDU "" (empty string)
NIWLANA_VAL_OFDM_DEMOD_PPDU_TYPE_MU_PPDU "userx"
NIWLANA_VAL_STANDARD_80211AX_MIMO_OFDM NIWLANA_VAL_OFDM_DEMOD_PPDU_TYPE_SU_PPDU, NIWLANA_VAL_OFDM_DEMOD_EXTENDED_RANGE_SU_PPDU "" (empty string)
NIWLANA_VAL_OFDM_DEMOD_PPDU_TYPE_MU_PPDU, NIWLANA_VAL_OFDM_DEMOD_TRIGGER_BASED_PPDU "userx

Parameters

Input
Name Type Description
session niWLANAnalysisSession Specifies the niWLAN analysis session refnum.
dataArraySize int32 Specifies the number of elements in the data array.
Output
Name Type Description
decodedBits int32[] Returns the sequence of bits obtained from the signal after demodulation and decoding for each iteration while the toolkit processes the acquired burst.
actualArraySize int32* Returns the number of elements in the data array. If the decodedBits array is not large enough to hold all the samples, the function returns an error and this parameter returns the minimum expected size of the output array.

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