niWLANA_ConfigureFastEVM

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_ConfigureFastEVM (niWLANAnalysisSession session, int32 standard, float64 channelBandwidth[]);

Purpose

Configures the toolkit for an EVM measurement that is optimized for speed. Use this function in a power amplifier (PA) test setup consisting of an NI RF vector signal generator feeding an RF signal to a PA device-under-test (DUT), in which the RF output signal is being analyzed by the signal analyzer. The niWLANA_ConfigureFastEVM function runs only if there is no carrier frequency offset and sample clock offset between the generator and the analyzer.

If you set the standard parameter 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_STANDARD_80211AC_MIMO_OFDM, NIWLANA_VAL_STANDARD_80211AF_MIMO_OFDM, or NIWLANA_VAL_STANDARD_80211AX_MIMO_OFDM the function disables the following: impairments estimation, header detection, burst start detection, channel EVM measurement, channel matrix power measurement, spectral flatness margin measurement, MAC FCS check, VHT-SIG-B CRC check, and 80211n PLCP frame format detection.

If you set the standard parameter to NIWLANA_VAL_STANDARD_80211BG_DSSS, the function disables the following: impairments estimation, burst start detection, header detection, and MAC FCS check.

If you set the standard parameter 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_STANDARD_80211AC_MIMO_OFDM, NIWLANA_VAL_STANDARD_80211AF_MIMO_OFDM, or NIWLANA_VAL_STANDARD_80211AX_MIMO_OFDM the following tasks are applicable.

  • The function completes the following tasks:
    • Sets the NIWLANA_OFDM_DEMOD_AUTO_COMPUTE_MEASUREMENT_LENGTH_ENABLED attribute to NIWLANA_VAL_TRUE.
    • Sets the NIWLANA_OFDM_DEMOD_CFO_ESTIMATION_METHOD attribute to NIWLANA_VAL_FALSE.
    • Sets the NIWLANA_OFDM_DEMOD_SAMPLE_CLOCK_OFFSET_ESTIMATION_ENABLED attribute to NIWLANA_VAL_FALSE.
    • Sets the NIWLANA_OFDM_DEMOD_IQ_GAIN_IMBALANCE_ESTIMATION_ENABLED attribute to NIWLANA_VAL_FALSE.
    • Sets the NIWLANA_OFDM_DEMOD_QUADRATURE_SKEW_ESTIMATION_ENABLED attribute to NIWLANA_VAL_FALSE.
    • Sets the NIWLANA_OFDM_DEMOD_TIMING_SKEW_ESTIMATION_ENABLED attribute to NIWLANA_VAL_FALSE.
    • Sets the NIWLANA_OFDM_DEMOD_CARRIER_FREQUENCY_LEAKAGE_ESTIMATION_ENABLED attribute to NIWLANA_VAL_FALSE.
    • Sets the NIWLANA_OFDM_DEMOD_COMMON_PILOT_ERROR_ESTIMATION_ENABLED attribute to NIWLANA_VAL_FALSE.
    • Sets the NIWLANA_OFDM_DEMOD_COMMON_PHASE_ERROR_ESTIMATION_ENABLED attribute to NIWLANA_VAL_FALSE.
    • Sets the NIWLANA_OFDM_DEMOD_HEADER_DETECTION_ENABLED attribute to NIWLANA_VAL_FALSE.
    • Sets the NIWLANA_OFDM_DEMOD_BURST_START_DETECTION_ENABLED attribute to NIWLANA_VAL_FALSE.
    • Sets the NIWLANA_OFDM_DEMOD_CHANNEL_EVM_ENABLED attribute to NIWLANA_VAL_FALSE.
    • Sets the NIWLANA_OFDM_DEMOD_CHANNEL_MATRIX_POWER_ENABLED attribute to NIWLANA_VAL_FALSE.
    • Sets the NIWLANA_OFDM_DEMOD_SPECTRAL_FLATNESS_MARGIN_ENABLED attribute to NIWLANA_VAL_FALSE.
    • Sets the NIWLANA_OFDM_DEMOD_UNUSED_TONE_ERROR_ENABLED attribute to NIWLANA_VAL_FALSE.
    • Sets the NIWLANA_OFDM_DEMOD_MAC_FRAME_CHECK_SEQUENCE_CHECK_ENABLED attribute to NIWLANA_VAL_FALSE.
    • Sets the NIWLANA_OFDM_DEMOD_VHT_SIG_B_CRC_CHECK_ENABLED attribute to NIWLANA_VAL_FALSE.
    • Sets the NIWLANA_OFDM_DEMOD_80211N_PLCP_FRAME_DETECTION_ENABLED attribute to NIWLANA_VAL_FALSE.

Because the niWLANA_ConfigureFastEVM function configures the preceding attributes, you must configure the following attributes:

  • NIWLANA_OFDM_DEMOD_MAXIMUM_SYMBOLS_USED
  • NIWLANA_OFDM_PPDU_TYPE
  • NIWLANA_OFDM_PAYLOAD_LENGTH
  • NIWLANA_OFDM_L_SIG_PAYLOAD_LENGTH
  • NIWLANA_OFDM_DATA_RATE
  • NIWLANA_MCS_INDEX
  • NIWLANA_GUARD_INTERVAL TYPE
  • NIWLANA_STBC_INDEX
  • NIWLANA_NUMBER_OF_SPACE_TIME_STREAMS
  • NIWLANA_80211N_PLCP_FRAME_FORMAT
  • NIWLANA_OFDM_RU_SIZE
  • NIWLANA_OFDM_RU_OFFSET
  • NIWLANA_OFDM_NUMBER_OF_USERS
  • NIWLANA_OFDM_DCM_ENABLED
  • NIWLANA_NUMBER_OF_HE_SIG_B_SYMBOLS
  • NIWLANA_HE_LTF_SIZE
  • NIWLANA_MIDAMBLE_PERIODICITY
  • NIWLANA_SPACE_TIME_STREAM_OFFSET
  • NIWLANA_NUMBER_OF_HE_LTF_SYMBOLS
  • NIWLANA_MU_MIMO_LTF_MODE_ENABLED

If the standard parameter is set to 80211B/G DSSS, the following is applicable.

The function completes the following tasks:

  • Sets the NIWLANA_DSSS_DEMOD_AUTO_COMPUTE_MEASUREMENT_LENGTH_ENABLED attribute to NIWLANA_VAL_TRUE.
  • Sets the NIWLANA_DSSS_DEMOD_CARRIER_FREQUENCY_OFFSET_ESTIMATION_ENABLED attribute to NIWLANA_VAL_FALSE.
  • Sets the NIWLANA_DSSS_DEMOD_SAMPLE_CLOCK_OFFSET_ESTIMATION_ENABLED attribute to NIWLANA_VAL_FALSE.
  • Sets the NIWLANA_DSSS_DEMOD_IQ_GAIN_IMBALANCE_ESTIMATION_ENABLED attribute to NIWLANA_VAL_FALSE.
  • Sets the NIWLANA_DSSS_DEMOD_QUADRATURE_SKEW_ESTIMATION_ENABLED attribute to NIWLANA_VAL_FALSE.
  • Sets the NIWLANA_DSSS_DEMOD_CARRIER_SUPPRESSION_ESTIMATION_ENABLED attribute to NIWLANA_VAL_FALSE.
  • Sets the NIWLANA_DSSS_DEMOD_BURST_START_DETECTION_ENABLED attribute to NIWLANA_VAL_FALSE.
  • Sets the NIWLANA_DSSS_DEMOD_HEADER_DETECTION_ENABLED attribute to NIWLANA_VAL_FALSE.
  • Sets the NIWLANA_DSSS_DEMOD_MAC_FRAME_CHECK_SEQUENCE_CHECK_ENABLED attribute to NIWLANA_VAL_FALSE.

Because the function configures the preceding attributes, you must configure the following attributes:

  • NIWLANA_DSSS_DEMOD_MAXIMUM_CHIPS_USED
  • NIWLANA_DSSS_PAYLOAD_LENGTH
  • NIWLANA_DSSS_DATA_RATE

Parameters

Input
Name Type Description
session niWLANAnalysisSession Specifies the niWLAN analysis session refnum.
standard int32

Specifies the IEEE 802.11 standard, which includes the type of physical layer, for signal analysis. The default value is NIWLANA_VAL_STANDARD_80211AG_OFDM.

NIWLANA_VAL_STANDARD_80211AG_OFDM (0), NIWLANA_VAL_STANDARD_80211J_OFDM (7), NIWLANA_VAL_STANDARD_80211P_OFDM (8) Corresponds to the OFDM mode defined in the IEEE Standard 802.11a-1999, IEEE Standard 802.11j-2004, and IEEE Standard 802.11p-2010, and the extended rate physical layer-OFDM (ERP-OFDM) mode, as defined in IEEE Standard 802.11g-2003.
NIWLANA_VAL_STANDARD_80211BG_DSSS (1) Corresponds to all the compulsory and optional modes defined in IEEE Standard 802.11b-1999 and the ERP-packet binary convolutional coding (ERP-PBCC) mode in IEEE Standard 802.11g-2003.
NIWLANA_VAL_STANDARD_80211G_DSSS_OFDM (2) Corresponds to the optional DSSS-OFDM mode defined in IEEE Standard 802.11g-2003.
NIWLANA_VAL_STANDARD_80211N_MIMO_OFDM (3) Corresponds to IEEE Standard 802.11n-2009.
NIWLANA_VAL_STANDARD_80211AC_MIMO_OFDM (4) Corresponds to IEEE Standard 802.11ac-2013.
NIWLANA_VAL_STANDARD_80211AF_MIMO_OFDM (5) Corresponds to IEEE Standard 802.11af-2013.
NIWLANA_VAL_STANDARD_80211AX_MIMO_OFDM (6) Corresponds to IEEE Standard IEEE P802.11ax/D3.0.
channelBandwidth float64[] Specifies the channel bandwidth.

The default value is 20 MHz.

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