Company Events Academic Community Support Solutions Products & Services Contact NI MyNI

niWLANG_SetNumberOfTransmitChannels

NI WLAN Generation Toolkit 17.0 Help

Edition Date: May 2017

Part Number: 373725G-01

»View Product Info
Download Help (Windows Only)

int32 __stdcall niWLANG_SetNumberOfTransmitChannels (niWLANGenerationSession session, char channelString[], int32 numberOfTransmitChannels);

Purpose

Specifies the number of transmit channels for multiple input multiple output (MIMO) signals, as defined in section 20.3.3 of IEEE Standard 802.11n-2009.

The number of transmit channels must be greater than or equal to the number of space-time streams if you set the NIWLANG_MAPPING_MATRIX_TYPE attribute to NIWLANG_VAL_MAPPING_MATRIX_TYPE_DIRECT. If you set the NIWLANG_MAPPING_MATRIX_TYPE attribute to values other than NIWLANG_VAL_MAPPING_MATRIX_TYPE_DIRECT, the number of transmit channels must be greater than or equal to the sum of the number of space-time streams and the NIWLANG_NUMBER_OF_EXTENSION_SPATIAL_STREAMS attribute. The toolkit defines the number of space-time streams using the NIWLANG_MCS_INDEX attribute and the NIWLANG_STBC_INDEX attribute as specified in IEEE Standard 802.11n-2009.

If you set the NIWLANG_STANDARD attribute to NIWLANG_VAL_STANDARD_80211AG_OFDM, NIWLANG_VAL_STANDARD_80211J_OFDM, NIWLANG_VAL_STANDARD_80211P_OFDM, NIWLANG_VAL_STANDARD_80211BG_DSSS, or NIWLANG_VAL_STANDARD_80211G_DSSS_OFDM and the niWLANG_SetNumberOfTransmitChannels function to greater than one, the same waveform is generated on multiple RFSG devices inside the niWLANG_RFSGCreateAndDownloadMIMOWaveforms function.

Parameters

Input
Name Type Description
session niWLANGenerationSession Specifies the niWLAN generation session.
channelString char[] Set this parameter to "" (empty string) or NULL.
numberOfTransmitChannels int32 Specifies the number of transmit channels for MIMO signals. The default value is 1. If you set the NIWLANG_STANDARD attribute to NIWLANG_VAL_STANDARD_80211N_MIMO_OFDM or NIWLANG_VAL_STANDARD_80211AH_MIMO_OFDM, the valid values are 1 to 4, inclusive. If you set the NIWLANG_STANDARD attribute to any other value, the valid values are 1 to 8, inclusive.

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 the function to determine if an error occurred.

To obtain a text description of the status code, call the niWLANG_GetErrorString function.

The general meaning of the status code is as follows:

Value Meaning
0 Success
Positive Values Warnings
Negative Values Errors

 

Your Feedback! poor Poor  |  Excellent excellent   Yes No
 Document Quality? 
 Answered Your Question? 
Add Comments 1 2 3 4 5 submit