Main Content

wlanWURSubchannel

Configure WUR 20 MHz subchannel

Description

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

Creation

Description

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

example

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

expand all

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

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

Data Types: double

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

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

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

HDR CSD values, in nanoseconds, for the WUR-Sync and WUR-Data fields, specified as a real-valued row vector of length NT, 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, NT 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 NT, the object uses only the first NT elements. For example, if NT = 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

LDR CSD values, in nanoseconds, for the WUR-Data field, specified as a real-valued row vector of length NT, 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, NT 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 NT, the object uses only the first NT elements. For example, if NT = 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

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

collapse all

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 P802.11ba/D8.0. “Part 11: Wireless LAN Medium Access Control (MAC) and Physical Layer (PHY) Specifications. Amendment 3: Wake-Up Radio Operation.” Draft 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™.

Introduced in R2021b