networkTrafficVoIP

VoIP application traffic pattern generator

Since R2020b

Download Required: To use networkTrafficVoIP, first download the Communications Toolbox Wireless Network Simulation Library add-on.

Description

The networkTrafficVoIP object specifies the configuration parameters to generate a voice over Internet protocol (VoIP) application traffic pattern based on the IEEE^® 802.11ax™ Evaluation Methodology.

You can use the VoIP application traffic pattern in system-level simulations to model the real-world data traffic.

Creation

Syntax

cfgVoIP = networkTrafficVoIP

cfgVoIP = networkTrafficVoIP(Name=Value)

Description

cfgVoIP = networkTrafficVoIP creates a default VoIP application traffic pattern object.

cfgVoIP = networkTrafficVoIP(Name=Value) sets properties using one or more name-value arguments. For example, HasJitter=false specifies that the VoIP application pattern does not model jitter.

Properties

ExponentialMean — Mean value for exponential distribution

1250 (default) | nonnegative integer

Mean value for the exponential distribution, specified as a nonnegative integer. The object uses this property to calculate the exponentially distributed active or silent state duration in the VoIP traffic.

Data Types: double

HasJitter — Flag to indicate whether to model jitter

true or 1 (default) | false or 0

Flag to indicate whether the object models jitter, specified as a logical 1 (true) or 0 (false).

Data Types: logical

LaplaceScale — Scale parameter for Laplace distribution

5.11 (default) | scalar in the range [1, 100]

Scale parameter for the Laplace distribution, specified as a scalar in the range [1, 100]. The object uses this property and the LaplaceMu property to calculate the packet arrival delay jitter in milliseconds.

Dependencies

To enable this property, set the HasJitter property to true.

Data Types: double

LaplaceMu — Location parameter for Laplace distribution

0 (default) | scalar in the range [0, 100]

Location parameter for the Laplace distribution, specified as a scalar in the range [0, 100]. The object uses this property and the LaplaceScale property to calculate packet arrival delay jitter in milliseconds.

Dependencies

To enable this property, set the HasJitter property to true.

Data Types: double

GeneratePacket — Flag to indicate whether to generate a VoIP packet

false or 0 (default) | true or 1

Flag to indicate whether the object generates a VoIP packet with payload, specified as a 0 (false) or logical 1 (true).

Data Types: logical

ApplicationData — Application data to be added in VoIP packet

36-element column vector of 1s (default) | column vector of integers in the range [0, 255]

Application data to be added in the VoIP packet, specified as a column vector of integers in the range [0, 255]. If the size of the application data is greater than the packet size, the object truncates the application data. If the size of the application data is less than the packet size, the object appends zeros.

Dependencies

To enable this property, set the GeneratePacket property to 1 (true).

Data Types: double

Object Functions

Specific to This Object

generate

Generate next FTP, On-Off, VoIP, or video conference application traffic packet

Examples

Generate VoIP Application Traffic Pattern

Create a default VoIP application traffic pattern object.

cfgVoIP = networkTrafficVoIP;

Generate a VoIP application traffic pattern.

[dt,packetSize] = generate(cfgVoIP);

Generate VoIP Application Traffic Pattern Using Mean Value of Exponential Distribution

Create a VoIP application traffic pattern object, specifying the mean value of the exponential distribution.

cfgVoIP = networkTrafficVoIP(ExponentialMean=5);

Generate a VoIP application traffic pattern.

[dt,packetSize] = generate(cfgVoIP); 

Generate VoIP Application Traffic Pattern and Data Packet

Create a VoIP application traffic pattern object to generate a VoIP data packet.

cfgVoIP = networkTrafficVoIP('GeneratePacket',true);

Generate a VoIP application traffic pattern and data packet.

[dt,packetSize,packet] = generate(cfgVoIP); 

Generate VoIP Application Traffic Pattern to Visualize Packet Sizes and Intervals

Create a default VoIP application traffic pattern object.

cfgVoIP = networkTrafficVoIP;

Generate a VoIP application traffic pattern with 200 VoIP packets.

numPkts = 200;
dt = zeros(1,numPkts);
packetSize = zeros(1,numPkts);
for packetCount = 1:numPkts
    [dt(packetCount),packetSize(packetCount)] = generate(cfgVoIP);
end

Visualize the VoIP packet sizes.

stem(packetSize);
title('Packet Size Versus Packet Number');
xlabel('Packet Number');
ylabel('Packet Size in Bytes');

Visualize the VoIP packet intervals.

figure;
stem(dt);
title('dt Versus Packet Number');
xlabel('Packet Number');
ylabel('dt in Milliseconds');

References

[1] IEEE 802.11™-14/0571r12. "11ax Evaluation Methodology." IEEE P802.11. Wireless LANs. https://www.ieee.org.

Extended Capabilities

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

Version History

Introduced in R2020b

R2023a: Moved to Communications Toolbox Wireless Network Simulation Library from 5G Toolbox and WLAN Toolbox

Previously, networkTrafficVoIP required 5G Toolbox™ or WLAN Toolbox™.