pcapWriter

PCAP file writer of protocol packets

Since R2020b

Description

The pcapWriter object writes generated and recovered protocol packets to a packet capture (PCAP) file (.pcap).

You can write these packet types to a PCAP file:

• Generated and recovered WLAN protocol packets

• Generated and recovered 5G NR protocol packets (requires 5G Toolbox™)

• Generated and recovered Bluetooth low energy (LE) link layer (LL) packets (requires Bluetooth^® Toolbox)

Creation

Syntax

pcapObj = pcapWriter

pcapObj = pcapWriter(Name,Value)

Description

pcapObj = pcapWriter creates a default PCAP file writer object.

pcapObj = pcapWriter(Name,Value) sets properties using one or more name-value pair arguments. Enclose each property name in quotes. For example, 'ByteOrder','big-endian' specifies the byte order as big-endian.

Properties

Note

The pcapWriter object does not overwrite the existing PCAP file. During each call of this object, specify a unique PCAP file name.

FileName — Name of the PCAP file

'capture' (default) | character row vector | string scalar

Name of the PCAP file, specified as a character row vector or a string scalar.

Data Types: char | string

ByteOrder — Byte order

'little-endian' (default) | 'big-endian'

Byte order, specified as 'little-endian' or 'big-endian'.

Data Types: char | string

Object Functions

Specific to This Object

write	Write protocol packet data to PCAP or PCAPNG file
writeGlobalHeader	Write global header to PCAP file

Examples

Write WLAN Packet to PCAP File

Create a PCAP file writer object, specifying the name of the PCAP file. Specify the link type for WLAN packet.

pcapObj = pcapWriter('FileName','writeWLANpacketdata2');
wlanLinkType = 105;

Write a global header to the PCAP file.

writeGlobalHeader(pcapObj,wlanLinkType);

Specify a WLAN packet.

mpdu = 'B4000000FFFFFFFFFFFF00123456789BA79A5B28';

Write the WLAN packet to the PCAP file.

timestamp = 124800; % Number of microseconds
write(pcapObj,mpdu,timestamp);

References

[1] “Radiotap - Introduction.” Accessed May 20, 2020. https://www.radiotap.org/.

[2] Group, The Tcpdump. “Tcpdump/Libpcap Public Repository.” Accessed May 20, 2020. https://www.tcpdump.org.

[3] “Development/LibpcapFileFormat - The Wireshark Wiki.” Accessed May 20, 2020. https://www.wireshark.org.

Extended Capabilities

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

Version History

Introduced in R2020b