Main Content

Wireless Waveform Analyzer

Analyze, visualize, and take measurements from WLAN waveforms

Since R2024a

expand all in page

Description

The Wireless Waveform Analyzer app enables you to blindly detect, decode, and analyze an IEEE® 802.11a™, IEEE 802.11n™, IEEE 802.11ac™, IEEE 802.11ax™ or IEEE 802.11be™ packet in an imported waveform. Using this app, you can:

  • Import waveforms from baseband files (.bb) or MATLAB files (.mat). The app requires the imported waveform to have fields labeled: 

    • waveform — Time-domain signal, specified as a complex-valued NS-by-NR matrix, where NS is the number of time-domain samples and NR is the number of receive antennas.

    • fs — Waveform sample rate in Hertz.

    If the imported waveform does not contain a field labeled waveform, the app uses the first field that is a vector or a 2D matrix of a double or single data type with complex number support as the input waveform. When a field labeled fs is not present, the app uses the current value of the Sample rate field in its Waveform Parameters section.

  • Detect an IEEE 802.11a™, IEEE 802.11n™, IEEE 802.11ac™, IEEE 802.11ax™, or IEEE 802.11be packet in an imported waveform.

  • Capture waveforms using a connected spectrum analyzer instrument that supports the virtual instrument software architecture (VISA) interface (requires Instrument Control Toolbox™).

  • Configure demodulation parameters to demodulate the waveform.

  • Analyze the demodulated waveform.

  • Visualize waveforms. You can choose from various visualization options such as spectrum analyzer, constellation diagram, and analysis summaries.

  • Export the results to files, or save them as workspace variables.

The Wireless Waveform Analyzer is capable of detecting, decoding, and analyzing a single packet within a waveform. For detecting, decoding, and analyzing multiple packets within a waveform, see the Recover and Analyze Packets in 802.11 Waveform example. Additionally, this example supports signal reception with a software defined radio, offers pilot time tracking for lengthy waveforms, and supports the retrieval of medium access control (MAC) frame contents.

Open the Wireless Waveform Analyzer App

  • MATLAB® Toolstrip: On the Apps tab, under Signal Processing and Communications, click the app icon. Wireless Waveform Analyzer

  • MATLAB Command Prompt: Enter wirelessWaveformAnalyzer

Examples

expand all

Open Live Script

Open the Wireless Waveform Analyzer app. On the app toolstrip, click Import. In the dialog box, select a file that contains a WLAN waveform with a PHY format of the IEEE 802.11ax™ and a sample rate of 20 MHz. The Wireless Waveform Analyzer app automatically updates the File name field in the waveform panel. The app updates the Sample rate field in the waveform panel because the selected file contains sample rate information. If you select a fie that does not contain sample rate information, update the Sample rate (Hz) field manually. Additionally, regardless of the file selected, you must always update the Channel bandwidth field manually. The value of the Channel bandwidth field must be less than or equal to the value of the Sample rate field.

In the Demodulation Parameters section of the panel, clear the Track pilot time, Track pilot phase, and Track pilot gain parameters, and set the Equalization method field to ZF.

Default_wwa.png

On the app toolstrip, click Analyze. By default, the app enables all visualization options. To remove a visualization option, on the app toolstrip, select Visualize, and clear the visualizations you want to remove.

vis_wwa.png

On the app toolstrip, click the top part of the Export button to export the post-simulation results to the MATLAB workspace. If you click the bottom part of the Export button, you can choose to export the post-simulation results to either the workspace or a MAT file.

Related Examples

Version History

Introduced in R2024a

expand all

See Also

Apps