/isac-plm

Integrated Sensing and Communication Physical layer (PHY) model of IEEE 802.11ay/bf.

Primary LanguageMATLAB

Integrated Sensing and Communication Physical Layer Model (ISAC-PLM)

Integrated Sensing and Communication Physical layer (PHY) model of IEEE 802.11ay/bf.

drawing

drawing

Table of Contents

Features

  • Support for IEEE 802.11ay including Single Carrier/OFDM waveform generation and spatial multiplexing schemes: SU-SISO, SU-MIMO, MU-MIMO.
  • Comprehensive performance analysis tools: link-level BER, PER, data rate testing, and analytical SE bounds.
  • Receiver algorithms for synchronization, channel estimation, carrier frequency offset (CFO) correction.
  • Integrated sensing capabilities using both passive and active techniques.
  • Sensing signal processing algorithms for clutter removal, 2D-CFAR, doppler processing, target detection, and range/velocity estimation.
  • Sensing accuracy evaluated using Mean Squared Error (MSE) and Normalized Mean Squared Error (NMSE).

Installation

Downloading or cloning the repository is all that's required—no further installation steps needed.

Requirements

  • The software is developed in MATLAB and tested on MATLAB R2023b.
  • Requires the MATLAB WLAN toolbox.

How to Run

  • Navigate to main.m, and modify the variable scenarioNameStr to match the name of your desired scenario folder scenarioFolder within .\examples.
  • Run main.m

Documentation

Extensive documentation is provided in docs/isac-plm.pdf, detailing ISAC-PLM's architecture, functionalities, and usage guidelines.

Examples Provided

A collection of predefined examples demonstrating various configurations and scenarios is available in /src/examples/ . The table below outlines the predefined examples along with their key configuration parameters:

Example Number of Rx Streams/rx Channel Model Precoder Packet
sisoOfdmAwgn_data 1 1 AWGN - PSDU
sisoSc_data 1 1 Rayleigh - PSDU
sisoOfdm_data 1 1 Rayleigh - PSDU
sisoSc 1 1 Rayleigh - PPDU
sisoOfdm 1 1 Rayleigh - PPDU
mimoSc_data 1 2 Rayleigh RZF (Freq flat) PSDU
mimoOfdm_data 1 2 Rayleigh RZF (Freq sel) PSDU
mimoSc 1 2 Rayleigh RZF (Freq flat) PPDU
mimoOfdm 1 2 Rayleigh RZF (Freq sel) PPDU
muMimoSc_data 2 2 Rayleigh ZF (Time domain) PSDU
muMimoOfdm_data 2 2 Rayleigh RZF (Freq sel) PSDU
muMimoOfdm 2 2 Rayleigh RZF (Freq sel) PPDU
pointTargetPassiveSensing 1 1 NIST QD - PPDU
singleHumanTarget 1 1 NIST QD - PPDU
pointTargetActiveSensing 1 1 NIST QD - TRN-R
bistaticLivingRoomTRN-R 1 1 NIST QD - TRN-R
bistaticLivingRoomTRN-T 1 1 NIST QD - TRN-T
bistaticLivingRoomBeacon 1 1 NIST QD - Beacon
thresholdSensing 1 1 NIST QD - PPDU
vitalSignSensing 1 1 NIST Measurements - TRN-R

References

IEEE 802.11bf contributions

Contributing

We welcome feedback and contributions! Please reach out to the repository administrator for collaboration or queries.

Contact information

Steve Blandino, NIST Communications Technology Laboratory, steve.blandino@nist.gov .

Credits

Special thanks to our contributors:

Cite

If you use ISAC-PLM in your reseach, please see CITATION.cff and cite it as follows:

NIST Communications Technology Laboratory, Integrated Sensing and Communication Physical Layer Model (ISAC-PLM), https://github.com/wigig-tools/isac-plm.

License

Please refer to the NIST-License.md and MathWorks-Limited-License.md files in the license folder for more information.