ruInfo
Resource unit allocation information
Syntax
Description
Examples
Create a single-user HE configuration object. Get and display the RU allocation information for the configured object.
cfgHESU = wlanHESUConfig; infoHESU = ruInfo(cfgHESU); disp(infoHESU)
NumUsers: 1
NumRUs: 1
RUIndices: 1
RUSizes: 242
NumUsersPerRU: 1
NumSpaceTimeStreamsPerRU: 1
PowerBoostFactorPerRU: 1
RUNumbers: 1
RUAssigned: 1
Now 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.
cfgHEMU = wlanHEMUConfig(5); infoHEMU = ruInfo(cfgHEMU); disp(infoHEMU)
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]
RUAssigned: [1 1 1 1 1 1 1]
Create a multiuser HE configuration object with the allocation index set to 96. This setting specifies a configuration with two 106-tone RUs, both with one user. Display the RU allocation information to show this.
cfg = wlanHEMUConfig(96); info = ruInfo(cfg); disp(info)
NumUsers: 2
NumRUs: 2
RUIndices: [1 2]
RUSizes: [106 106]
NumUsersPerRU: [1 1]
NumSpaceTimeStreamsPerRU: [1 1]
PowerBoostFactorPerRU: [1 1]
RUNumbers: [1 2]
RUAssigned: [1 1]
Set the station identity to 2046 for the second user. The RU allocation information now shows that only the first RU is assigned.
cfg.User{2}.STAID = 2046;
info = ruInfo(cfg);
disp(info) NumUsers: 2
NumRUs: 2
RUIndices: [1 2]
RUSizes: [106 106]
NumUsersPerRU: [1 1]
NumSpaceTimeStreamsPerRU: [1 1]
PowerBoostFactorPerRU: [1 1]
RUNumbers: [1 2]
RUAssigned: [1 0]
Create a wlanEHTMUConfig object with the allocation index set to the vector [27 64 64 64]. This setting specifies four 242-tone RUs. The RU represented by allocation index 27 is unassigned, which means that it does not transmit any user data. The remaining three RUs each have one user.
cfgUnassigned = wlanEHTMUConfig([27 64 64 64]);
Show the allocation and the RU information for the configuration. Both show three RUs and ignore the unassigned RU.
showAllocation(cfgUnassigned);
infoUnassigned = ruInfo(cfgUnassigned); disp(infoUnassigned)
NumUsers: 3
NumRUs: 3
RUIndices: {[2] [3] [4]}
RUSizes: {[242] [242] [242]}
NumUsersPerRU: [1 1 1]
NumSpaceTimeStreamsPerRU: [1 1 1]
PowerBoostFactorPerRU: [1 1 1]
RUNumbers: [1 2 3]
RUAssigned: [1 1 1]
Now create a wlanEHTMUConfig object with the allocation index set to the vector [64 64 64 64]. This setting specifies the same configuration as before, except the first RU is assigned.
cfgSTAID = wlanEHTMUConfig([64 64 64 64]);
Now set the STAID property of the first user to 2046. This setting specifies that the user's corresponding RU is unassigned.
cfgSTAID.User{1}.STAID=2046;Show the allocation. This allocation is the same as in the first case, except that the RUs are numbered 2–4 instead of 1–3. The object now considers the first RU to be present, even though the RU does not transmit user data.
showAllocation(cfgSTAID)
Show the RU information. All four RUs are present, but the first one is shown as unassigned.
infoSTAID = ruInfo(cfgSTAID); disp(infoSTAID)
NumUsers: 4
NumRUs: 4
RUIndices: {[1] [2] [3] [4]}
RUSizes: {[242] [242] [242] [242]}
NumUsersPerRU: [1 1 1 1]
NumSpaceTimeStreamsPerRU: [1 1 1 1]
PowerBoostFactorPerRU: [1 1 1 1]
RUNumbers: [1 2 3 4]
RUAssigned: [0 1 1 1]
