wlanWURSubchannel

Configure WUR 20 MHz subchannel

Since R2021b

Description

The wlanWURSubchannel object configures a 20 MHz subchannel of a WLAN wake-up radio (WUR) transmission.

Creation

Syntax

cfgSubchannel = wlanWURSubchannel

cfgSubchannel = wlanWURSubchannel(Name=Value)

Description

cfgSubchannel = wlanWURSubchannel configures a 20 MHz subchannel of an IEEE^® 802.11ba™ WUR transmission.

cfgSubchannel = wlanWURSubchannel(Name=Value) sets properties using one or more name-value arguments. For example, DataRate='LDR' specifies a data rate of 62.5 kb/s.

Properties

DataRate — Data rate

'HDR' (default) | 'LDR'

Data rate, specified as one of these values.

• 'HDR' — Data rate of 250 kb/s

• 'LDR' — Data rate of 62.5 kb/s

Data Types: char | string

PSDULength — PSDU length in bytes

8 (default) | integer in the interval [1, 22]

PSDU length in bytes, specified as an integer in the interval [1, 22].

Data Types: double

SymbolDesign — MC-OOK On symbol sequence and CSD values

'Example1' (default) | 'Example2' | 'Example3' | 'User-defined'

Multicarrier on-off keying (MC-OOK) On symbol sequence and cyclic shift diversity (CSD) values for the WUR-Sync and WUR-Data fields, specified as one of these values.

• 'Example1' — Use MC-OOK On symbol sequence and CSD values corresponding to Example 1 in Tables AC-1, AC-2, AC-3, and AC-4 of [1].

• 'Example2' — Use MC-OOK On symbol sequence and CSD values corresponding to Example 2 in Tables AC-1, AC-2, AC-3, and AC-4 of [1].

• 'Example3' — Use MC-OOK On symbol sequence and CSD values corresponding to Example 3 in Tables AC-1, AC-2, AC-3, and AC-4 of [1].

• 'User-defined' — Use MC-OOK On symbol sequence and CSD values corresponding to the HDRSequence, LDRSequence, HDRCSD, and LDRCSD properties.

Data Types: char | string

HDRSequence — Normalized HDR MC-OOK On symbol sequence

complex-valued row vector

Normalized high-data-rate (HDR) MC-OOK On symbol sequence for the WUR-Sync and WUR-Data fields, specified as a complex-valued row vector of length 13.

Dependencies

To enable this property, set the SymbolDesign property to 'User-defined'.

Data Types: double
Complex Number Support: Yes

LDRSequence — Normalized LDR MC-OOK On symbol sequence

complex-valued row vector

Normalized low-data-rate (LDR) MC-OOK On symbol sequence for the WUR-Data field, specified as a complex-valued row vector of length 13.

Dependencies

To enable this property, set the SymbolDesign property to 'User-defined'.

Data Types: double
Complex Number Support: Yes

HDRCSD — HDR CSD values

real-valued row vector

HDR CSD values, in nanoseconds, for the WUR-Sync and WUR-Data fields, specified as a real-valued row vector of length N_T, the number of transmit antennas in the WUR transmission. When you use this object as an element of the Subchannel property of a wlanWURConfig object, N_T must be the value of the NumTransmitAntennas property of that object.

Each element of this vector must be nonpositive.

Note

If you set this property as a row vector of length greater than N_T, the object uses only the first N_T elements. For example, if N_T = 4, the object uses only the first four elements of this vector.

Dependencies

To enable this property, set the SymbolDesign property to 'User-defined'.

Data Types: double

LDRCSD — LDR CSD values

real-valued row vector

LDR CSD values, in nanoseconds, for the WUR-Data field, specified as a real-valued row vector of length N_T, the number of transmit antennas in the WUR transmission. When you use this object as an element of the Subchannel property of a wlanWURConfig object, N_T must be the value of the NumTransmitAntennas property of that object.

Each element of this vector must be nonpositive.

Note

If you set this property as a row vector of length greater than N_T, the object uses only the first N_T elements. For example, if N_T = 4, the object uses only the first four elements of this vector.

Dependencies

To enable this property, set the SymbolDesign property to 'User-defined'.

Data Types: double

Enabled — Subchannel puncturing indication

true or 1 (default) | false or 0

Subchannel puncturing indication, specified as a numeric or logical 1 (true) or 0 (false). To puncture the subchannel, set this property to false. Otherwise, set this property to true.

When you use this object as an element of the Subchannel property of a wlanWURConfig object that configures a 20 or 40 MHz transmission, you must set this property to true.

When you use this object as an element of the Subchannel property of a wlanWURConfig object that configures an 80 MHz transmission, you must set this property to true in at least one of the wlanWURSubchannel objects.

Data Types: double | logical

Examples

Generate Oversampled WUR Waveform

Create a WUR configuration object, specifying four 20 MHz subchannels.

numSubchannels = 4;
cfgWUR = wlanWURConfig(numSubchannels);

Configure each 20 MHz subchannel.

psduLength = [4 8 12 16];
dataRate = {'LDR','HDR','LDR','HDR'};
design = {'Example1','Example2','Example1','Example1'};
cfgSubchannel = cell(1,numSubchannels);
psdu = cell(1,cfgWUR.NumUsers);
for i = 1:cfgWUR.NumUsers
    cfgSubchannel{i} = wlanWURSubchannel(PSDULength=psduLength(i), ...
        DataRate=dataRate{i},SymbolDesign=design{i});
    psdu{i} = randi([0 1],8*psduLength(i),1,'int8');
end
cfgWUR.Subchannel = cfgSubchannel;

Specify an oversampling factor of two, and then generate the waveform.

osf = 2;
waveform = wlanWaveformGenerator(psdu,cfgWUR,NumPackets=4, ...
    IdleTime=1e-5,OversamplingFactor=osf);

References

[1] IEEE Std 802.11ba-2021. “Part 11: Wireless LAN Medium Access Control (MAC) and Physical Layer (PHY) Specifications. Amendment 3: Wake-Up Radio Operation.” 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 R2021b