ruInfo
Resource unit allocation information
Syntax
Description
Examples
Get RU Allocation Information for HE Configuration Objects
Use the ruInfo
function to get the resource unit information of single user and multi-user HE configuration objects.
Get Single User RU Allocation Information
Create a single user HE configuration object. Get and display the RU allocation information for the configured object.
hesu = wlanHESUConfig; ru = ruInfo(hesu)
ru = struct with fields:
NumUsers: 1
NumRUs: 1
RUIndices: 1
RUSizes: 242
NumUsersPerRU: 1
NumSpaceTimeStreamsPerRU: 1
PowerBoostFactorPerRU: 1
RUNumbers: 1
Get Multiuser RU Allocation Information
Create a multiuser HE configuration object with the allocation index set to 5, which configures the object with seven users. Get and display the RU allocation information for the configured object.
hemu = wlanHEMUConfig(5); ru = ruInfo(hemu)
ru = struct with fields:
NumUsers: 7
NumRUs: 7
RUIndices: [1 2 2 5 6 7 4]
RUSizes: [26 26 52 26 26 26 52]
NumUsersPerRU: [1 1 1 1 1 1 1]
NumSpaceTimeStreamsPerRU: [1 1 1 1 1 1 1]
PowerBoostFactorPerRU: [1 1 1 1 1 1 1]
RUNumbers: [1 2 3 4 5 6 7]
Inactivate RU for Second User in Multiuser HE
Create a two user HE configuration object. Make the RU for the second user inactive by setting the station identity to 2046.
Create a multiuser HE configuration object with the allocation index set to 96, which configures an object for two users. The resource information shows that RUs are active for two users.
hemu = wlanHEMUConfig(96); ruInfo(hemu)
ans = struct with fields:
NumUsers: 2
NumRUs: 2
RUIndices: [1 2]
RUSizes: [106 106]
NumUsersPerRU: [1 1]
NumSpaceTimeStreamsPerRU: [1 1]
PowerBoostFactorPerRU: [1 1]
RUNumbers: [1 2]
Set the station identity to 2046 for the second user. The RU allocation information now shows that RUs are active only for RU index 1.
hemu.User{2}.STAID = 2046; ruInfo(hemu)
ans = struct with fields:
NumUsers: 2
NumRUs: 1
RUIndices: 1
RUSizes: 106
NumUsersPerRU: 1
NumSpaceTimeStreamsPerRU: 1
PowerBoostFactorPerRU: 1
RUNumbers: 1
Input Arguments
cfg
— Format configuration object
wlanEHTMUConfig
object | wlanEHTTBConfig
object | wlanHESUConfig
object | wlanHEMUConfig
object | wlanHETBConfig
object
Format configuration object, specified as an object of type wlanEHTMUConfig
, wlanEHTTBConfig
, wlanHEMUConfig
, wlanHESUConfig
, or wlanHETBConfig
.
Output Arguments
info
— Information about RU properties of object
structure
Information about the RU properties of the input object, returned as a structure.
NumUsers
— Number of users
integer in the range [1, 144]
Number of users, returned as an integer in the range [1, 144]. When you
specify cfg
as an object of type wlanHEMUConfig
, wlanHESUConfig
, or wlanHETBConfig
, the
maximum number of users is 74. When you specify cfg
as an
object of type wlanEHTMUConfig
or wlanEHTTBConfig
, the
maximum number of users is 144.
Data Types: double
NumRUs
— Number of RUs
integer in the range [1, 144]
Number of RUs, returned as an integer in the range [1, 144]. When you specify
cfg
as an object of type wlanHEMUConfig
, wlanHESUConfig
, or wlanHETBConfig
, the
maximum number of RUs is 74. When you specify cfg
as an
object of type wlanEHTMUConfig
or wlanEHTTBConfig
, the
maximum number of RUs is 144.
Data Types: double
RUIndices
— RU indices
integer | vector | cell array
RU indices, returned as:
An integer or a 1-by-
NumRUs
vector with elements that have integer values in the range [1, 74]. This applies when you specifycfg
as an object of typewlanHEMUConfig
,wlanHESUConfig
, orwlanHETBConfig
.A 1-by-
NumRUs
cell array of vectors with elements that have integer values in the range [1, 148]. This applies when you specifycfg
as an object of typewlanEHTMUConfig
orwlanEHTTBConfig
.
Data Types: double
| cell
RUSizes
— Resource unit sizes
integer | vector | cell array
Resource unit sizes, returned as:
An integer or a 1-by-
NumRUs
vector with elements that have integer values of26
,52
,106
,242
,484
,968
,996
, or1992
. This applies when you specifycfg
as an object of typewlanHEMUConfig
,wlanHESUConfig
, orwlanHETBConfig
.A 1-by-
NumRUs
cell array of vectors with elements that have integer values of26
,52
,106
,242
,484
,968
,996
,1992
, or3984
. This applies when you specifycfg
as an object of typewlanEHTMUConfig
orwlanEHTTBConfig
.
Data Types: double
NumUsersPerRU
— Number of users per RU
integer | vector
Number of users per RU, returned as an integer or a
1-by-NumRUs
vector with elements that have integer values
in the range [1, 8].
Data Types: double
NumSpaceTimeStreamsPerRU
— Number of space-time streams per RU
integer | vector
Number of space-time streams per RU, returned as an integer or a
1-by-NumRUs
vector with elements that have integer values in
the range [1, 8].
Data Types: double
PowerBoostFactorPerRU
— Power boost factor per RU
integer | vector
Power boost factor per RU, returned as an integer or a
1-by-NumRUs
vector with elements that have scalar values in
the range [0.5, 2].
Data Types: double
RUNumbers
— RU numbers
integer | vector
RU numbers, returned as an integer or a 1-by-NumRUs
vector with elements that have integer values in the range [1, 144].
RUNumbers
correspond to the indices for each active RU
configured in the cfg
.RU
object. An RU is
inactive when it contains a single station with its station identifier set to
2046.
Data Types: double
Data Types: struct
Extended Capabilities
C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.
Version History
Introduced in R2018bR2023a: EHT TB support
You can specify the input cfg
as an object of type wlanEHTTBConfig
.
R2022b: EHT MU packet format
You can specify cfg
as an object of type wlanEHTMUConfig
.
See Also
Objects
Functions
MATLAB-Befehl
Sie haben auf einen Link geklickt, der diesem MATLAB-Befehl entspricht:
Führen Sie den Befehl durch Eingabe in das MATLAB-Befehlsfenster aus. Webbrowser unterstützen keine MATLAB-Befehle.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)