Main Content

addIE

Update MAC management frame with IE

collapse all in page

Syntax

cfgUpdated = addIE(cfgMgmt,id,information)

Description

cfgUpdated = addIE(cfgMgmt,id,information) updates WLAN MAC management frame-body configuration cfgMgmt by appending an information element (IE). Specify the IE by its identifier id and information field information. The function returns cfgUpdated, an MAC management frame-body configuration whose InformationElements property contains the appended IE.

example

Examples

collapse all

Open Live Script

Add the DSSS Parameter Set information element to a WLAN MAC management frame-body configuration object by using the addIE object function. The element ID for this information element is 3. The information is '0b', representing the current channel (11) in hexadecimal format.

config = wlanMACManagementConfig('FrameType','Beacon');
id = 3;
information = '0b'
information = 
'0b'

config = addIE(config,id,information);

Display the information elements of the frame-body configuration object by using the displayIEs object function.

displayIEs(config)
Element ID: 0, Information: 0x64656661756C742053534944
Element ID: 1, Information: 0x8C98B0
Element ID: 3, Information: 0x0B

Input Arguments

collapse all

MAC management frame configuration, specified as a wlanMACManagementConfig object.

IE ID field, specified as a nonnegative integer in the interval [0,255]. For more information, see Table 9-92—Element IDs in [1].

Data Types: double

Value of information field in hexadecimal format, specified as a character vector or string scalar of hexadecimal octets. For more information, see Table 9-92—Element IDs in [1].

Data Types: char | string

Output Arguments

collapse all

Updated MAC management frame-body configuration, returned as a wlanMACManagementConfig object. The InformationElements property of this output contains the appended IE.

References

[1] IEEE Std 802.11™-2020 (Revision of IEEE Std 802.11-2016). “Part 11: Wireless LAN Medium Access Control (MAC) and Physical Layer (PHY) Specifications.” IEEE Standard for Information Technology — Telecommunications and Information Exchange between Systems — Local and Metropolitan Area Networks — Specific Requirements.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

Version History

Introduced in R2018b

See Also