NIWLANG_MAC_ADDRESS1

NI WLAN Generation Toolkit 18.0 Help

Edition Date: October 2018

Part Number: 373725J-01

»View Product Info
Download Help (Windows Only)

Data Type: int64
Access:read/write
Functions:niWLANG_SetScalarAttributeI64
niWLANG_GetScalarAttributeI64
Description: Specifies the Address1 field as defined in section 7.1.3 of IEEE Standard 802.11-2007 and IEEE Standard 802.11n-2009, section 8.2.4 of IEEE Standard 802.11ac-2013 and IEEE P802.11ah/D1.3, and section 9.2.4 of IEEE P802.11ax/D3.0. The length of this field is defined by the NIWLANG_MAC_ADDRESS1 Length attribute if you set the NIWLANG_MAC_FRAME_FORMAT attribute to NIWLANG_VAL_MAC_FRAME_FORMAT_SHORT; otherwise, the length is six bytes. If this field is a MAC address, it is represented with the least significant byte in the leftmost position and each byte is represented with the least significant bit in the rightmost position.

For example, the medium access control (MAC) address 12-34-56-78-9A-BC is represented by the number 0 x 123456789ABC.

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_80211G_DSSS_OFDM, NIWLANG_VAL_STANDARD_80211BG_DSSS, or NIWLANG_VAL_STANDARD_80211G_DSSS_OFDM, you must use an empty string to configure this attribute.

If you set the NIWLANG_STANDARD attribute to NIWLANG_VAL_STANDARD_80211N_MIMO_OFDM or NIWLANG_VAL_STANDARD_80211AH_MIMO_OFDM, you must use an empty string if the NIWLANG_AMPDU_ENABLED attribute is set to NIWLANG_VAL_FALSE, or use the 'mpdux' active channel string if the NIWLANG_AMPDU_ENABLED attribute is set to NIWLANG_VAL_TRUE, to configure this attribute.

If you set the NIWLANG_STANDARD attribute to NIWLANG_VAL_STANDARD_80211AC_MIMO_OFDM, you must use the following active channel string formats to configure this attribute:
An empty string if you set the NIWLANG_PPDU_TYPE attribute to NIWLANG_VAL_PPDU_TYPE_SU_PPDU and the NIWLANG_AMPDU_ENABLED attribute to NIWLANG_VAL_FALSE.
'mpdux' as the active channel string format if you set the NIWLANG_PPDU_TYPE attribute to NIWLANG_VAL_PPDU_TYPE_SU_PPDU and the NIWLANG_AMPDU_ENABLED attribute to NIWLANG_VAL_TRUE.
'userx/mpduy' as the active channel string format if you set the NIWLANG_PPDU_TYPE attribute to NIWLANG_VAL_PPDU_TYPE_MU_PPDU and the NIWLANG_AMPDU_ENABLED attribute to NIWLANG_VAL_TRUE.

If you set the NIWLANG_STANDARD attribute to NIWLANG_VAL_STANDARD_80211AF_MIMOOFDM, use an empty string active channel string format if you set the NIWLANG_PPDU_TYPE attribute to NIWLANG_VAL_PPDU_TYPE_SU_PPDU and the NIWLANG_AMPDU_ENABLED attribute to NIWLANG_VAL_FALSE, or use the 'mpdux' active channel string if you set the NIWLANG_PPDU_TYPE attribute to NIWLANG_VAL_PPDU_TYPE_SU_PPDU and the NIWLANG_AMPDU_ENABLED attribute to NIWLANG_VAL_TRUE.
If you set the NIWLANG_STANDARD attribute to NIWLANG_VAL_STANDARD_80211AX_MIMO_OFDM, use the following active channel string formats to configure this attribute:
Use an empty string active channel string format if you set the NIWLANG_PPDU_TYPE attribute to NIWLANG_VAL_PPDU_TYPE_SU_PPDU or NIWLANG_VAL_PPDU_TYPE_EXTENDED_RANGE_SU_PPDU and the NIWLANG_AMPDU_ENABLED attribute to NIWLANG_VAL_FALSE.
Use the 'mpdux' active channel string format if you set the NIWLANG_PPDU_TYPE attribute to NIWLANG_VAL_PPDU_TYPE_SU_PPDU or NIWLANG_VAL_PPDU_TYPE_EXTENDED_RANGE_SU_PPDU and the NIWLANG_AMPDU_ENABLED attribute to NIWLANG_VAL_TRUE.
Use the 'userx/mpduy' as the active channel string format if you set the NIWLANG_PPDU_TYPE attribute to NIWLANG_VAL_PPDU_TYPE_MU_PPDU or NIWLANG_VAL_PPDU_TYPE_TRIGGER_BASED_PPDU and the NIWLANG_AMPDU_ENABLED attribute to NIWLANG_VAL_TRUE.

The default value is 0x0. Valid values are 0x0 to 0xFFFFFFFFFFFF. For values outside this range, the toolkit uses the least significant six bytes.

Set Function: niWLANG_SetMACAddress1
Get Function: niWLANG_GetMACAddress1

WAS THIS ARTICLE HELPFUL?

Not Helpful