wlanPSDULength

Calculate PSDU length in octets

Syntax

PSDULength = wlanPSDULength(cfgPHY,unit,value)

Description

PSDULength = wlanPSDULength(cfgPHY,unit,value) returns PSDULength, the physical layer conformance procedure (PLCP) service data unit (PSDU) length, in octets from the given value and the physical layer configuration cfgPHY. The value can be in terms of PLCP protocol data unit (PPDU) transmission time or number of data symbols, specified by the unit input argument.

Examples

Generate Non-HT Waveform with Specified Transmission Time

Create a wlanNonHTConfig object, 'cfgPHY', and specify the transmission time, 'txTime', in microseconds.

cfgPHY = wlanNonHTConfig;
txTime = 300;

Calculate the PSDU length in octets.

psduLength = wlanPSDULength(cfgPHY,'TxTime',txTime)

psduLength = 
207

Set the number of bytes carried in the user payload for the configuration object, 'cfgPHY', to this PSDU length. Create a random PSDU, 'psdu', using the calculated PSDU length.

cfgPHY.PSDULength = psduLength;
data = randi([0 1],psduLength*8,1);

Generate a non-HT waveform using 'cfgPHY' and 'data'.

waveform = wlanWaveformGenerator(data,cfgPHY);

Generate HT Waveform with Specified Number of Data Symbols

Create a wlanHTConfig object, 'cfgPHY', and specify the number of data symbols, 'numDataSymbols'.

cfgPHY = wlanNonHTConfig;
numDataSymbols = 200;

Calculate the PSDU length in octets.

psduLength = wlanPSDULength(cfgPHY,'NumDataSymbols',numDataSymbols)

psduLength = 
597

Set the number of bytes carried in the user payload for the configuration object, 'cfgPHY', to this PSDU length. Create a random PSDU, 'psdu', with the calculated PSDU length.

cfgPHY.PSDULength = psduLength;
data = randi([0 1],psduLength*8,1);

Generate a non-HT waveform using 'cfgPHY' and 'data'.

waveform = wlanWaveformGenerator(data,cfgPHY);

Input Arguments

cfgPHY — PHY format configuration

wlanEHTMUConfig object | wlanHESUConfig object | wlanVHTConfig object | wlanHTConfig object | wlanNonHTConfig object

PHY format configuration, specified as a wlanEHTMUConfig, wlanHESUConfig, wlanVHTConfig, wlanHTConfig, or wlanNonHTConfig object. This object defines a PHY format configuration and its applicable properties.

Note

When you specify this input as a wlanEHTMUConfig object, it must be single-user.

unit — Units of argument value

'TxTime' | 'NumDataSymbols'

Units of the argument value, specified as 'TxTime' or 'NumDataSymbols'. This value indicates the units of value from which the PSDU length is calculated.

Data Types: char | string

value — Value from which PSDU length is calculated

numeric scalar

Value from which the PSDU length is calculated, specified as a numeric scalar. Input argument unit specifies the unit of value. This table describes how the function interprets value based on unit.

unit Value	value Description
'TxTime'	Scalar number specifying PPDU transmission time in microseconds
'NumDataSymbols'	Scalar number specifying the number of symbols in the 'Data' field of PPDU

Data Types: double

Output Arguments

PSDULength — Length of PSDU in octets

numeric scalar

Length of the PSDU in octets, returned as a numeric scalar. This value returns the maximum PSDU length that fits into the specified value of 'TxTime' or 'NumDataSymbols'.

Data Types: double

Extended Capabilities

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

Version History

Introduced in R2019b

R2024b: Calculate PSDU length for EHT SU configurations

You can now calculate the maximum PSDU length for EHT single-user configurations. To use this feature, specify the cfgPHY input as a wlanEHTMUConfig object that has one user.

R2024b: Exceeding TxTime limit for symbol boundary no longer causes error

When you specify unit as 'TxTime' and value makes the transmit time for the next symbol boundary higher than the maximum allowed, the function returns the PSDU length that corresponds to the highest valid transmit time.