Integrated Sensing and Communication Physical layer (PHY) model of IEEE 802.11ay/bf.
- Features
- Installation
- Requirements
- How to Run
- Examples Provided
- References
- Contributing
- Contact information
- Credits
- License
- 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).
Downloading or cloning the repository is all that's required—no further installation steps needed.
- The software is developed in MATLAB and tested on MATLAB R2023b.
- Requires the MATLAB WLAN toolbox.
- Navigate to
main.m, and modify the variablescenarioNameStrto match the name of your desired scenario folderscenarioFolderwithin.\examples. - Run
main.m
Extensive documentation is provided in docs/isac-plm.pdf, detailing ISAC-PLM's architecture, functionalities, and usage guidelines.
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 |
- S. Blandino, et al, Low Overhead DMG Sensing for Vital Signs Detection, 2024 IEEE International Conference on Acoustics, Speech and Signal Processing (ICASSP).
- S. Blandino, T. Ropitault, C. R. C. M. da Silva, A. Sahoo and N. Golmie, IEEE 802.11bf DMG Sensing: Enabling High-Resolution mmWave Wi-Fi Sensing, 2023 IEEE Open Journal of Vehicular Technology.
- N. Varshney et al., Adaptive Channel-State-Information Feedback in Integrated Sensing and Communication Systems, 2023 IEEE Internet of Things Journal.
- J. Zhang, S. Blandino, N. Varshney, J. Wang, C. Gentile and N. Golmie, Multi-User MIMO Enabled Virtual Reality in IEEE 802.11ay WLAN, 2022 IEEE Wireless Communication and Networking Conference.
- S. Blandino, T.Ropitault, A. Sahoo and N. Golmie, Tools, Models and Dataset for IEEE 802.11ay CSI-based Sensing, 2022 IEEE Wireless Communication and Networking Conference.
- DMG/EDMG Link Level Simulation Platform
- Implementation of 60 GHz WLAN-SENS Physical Layer Model
- TGbf Channel Models for WLAN Sensing Systems
- TGbf Evaluation Methodology and Simulation Scenarios
We welcome feedback and contributions! Please reach out to the repository administrator for collaboration or queries.
Steve Blandino, NIST Communications Technology Laboratory, [email protected] .
Special thanks to our contributors:
- Steve Blandino
- Neeraj Varshney
- Jian Wang
- Jiayi Zhang
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.
Please refer to the NIST-License.md and MathWorks-Limited-License.md files in the license folder for more information.