This is a repository for the development of IEEE 802.11ad model in ns-3 simulator. For additional information about the model and how to build the project, please check the Readme file or the Wiki Page on https://github.com/hanyassasa87/ns3-802.11ad/wiki
Switch branches/tags
Nothing to show
Clone or download
Permalink
Failed to load latest commit information.
Traces Fixed Bug Related to ATI Duration + Removed Unnecessary Debug Informa… Aug 8, 2017
bindings/python IEEE 802.11ad Model Implementation v0.3 Release Jun 12, 2017
contrib IEEE 802.11ad Model Implementation v0.3 Release Jun 12, 2017
doc IEEE 802.11ad Model Implementation v0.2 Release Oct 19, 2016
examples IEEE 802.11ad Model Implementation v0.3 Release Jun 12, 2017
scratch Correct bug related to storing the current transmission Mar 27, 2018
src Correct bug related to storing the current transmission Mar 27, 2018
utils Initial Commit Apr 10, 2016
waf-tools IEEE 802.11ad Model Implementation v0.2 Release Oct 19, 2016
.gitignore IEEE 802.11ad Model Implementation v0.2 Release Oct 19, 2016
AUTHORS IEEE 802.11ad Model Implementation v0.2 Release Oct 19, 2016
CHANGES.html IEEE 802.11ad Model Implementation v0.2 Release Oct 19, 2016
LICENSE Initial Commit Apr 10, 2016
Makefile Initial Commit Apr 10, 2016
README IEEE 802.11ad Model Implementation v0.3 Release Jun 12, 2017
RELEASE_NOTES IEEE 802.11ad Model Implementation v0.2 Release Oct 19, 2016
VERSION IEEE 802.11ad Model Implementation v0.2 Release Oct 19, 2016
test.py IEEE 802.11ad Model Implementation v0.2 Release Oct 19, 2016
testpy.supp Initial Commit Apr 10, 2016
utils.py Initial Commit Apr 10, 2016
utils.pyc IEEE 802.11ad Model Implementation v0.2 Release Oct 19, 2016
waf Initial Commit Apr 10, 2016
waf.bat Initial Commit Apr 10, 2016
wscript IEEE 802.11ad Model Implementation v0.3 Release Jun 12, 2017
wutils.py Initial Commit Apr 10, 2016
wutils.pyc IEEE 802.11ad Model Implementation v0.2 Release Oct 19, 2016

README

        WLAN IEEE 802.11ad Model in ns-3, Version 0.3
        ---------------------------------------------

Introduction:
-------------
This is a repository for the development of WLAN IEEE 802.11ad model in ns-3. 
The implemented model supports the following features:

1. DMG Channel Access Periods (BTI/A-BFT/ATI/DTI with both CBAP and Service Periods).
2. Beamforming Training (BT) in BHI and DTI.
3. Abstract DMG PHY layer for DMG CTRL/SC/OFDM.
4. Fast Session Transfer (FST) Mechanism.
5. DMG Relay Support (Full Duplex and Half Dyplex modes).
6. DMG PLCP Model for 802.11ad frame.
7. 60 GHz Directional Antenna Model.
8. Half Duplex DMG Relay Support.
9. Dynamic Channel Allocation (Polling).
10. Beamformed Link Maintenance.
11. Decentralized Clustering.
12. Spatial Sharing.

The implementation is based on the existing model of WLAN IEEE 802.11 in ns-3. 
The following papers include a background on IEEE 802.11ad, implementation details,
and evaluation section for this model. If you use our model in your research, 
please cite the following papers: 

Implementation and Evaluation of a WLAN IEEE 802.11ad Model in ns-3.
Hany Assasa, Joerg Widmer (June 2016)
The Workshop on ns-3 (WNS3 2016), 15-16 June 2016, Seattle, WA, USA

Link: http://dl.acm.org/citation.cfm?id=2915377

Extending the IEEE 802.11ad Model: Scheduled Access, Spatial Reuse, 
Clustering, and Relaying
Hany Assasa, Joerg Widmer (June 2017) 
The Workshop on ns-3 (WNS3), 13-14 June 2017, Porto, Portugal

http://eprints.networks.imdea.org/id/eprint/1566



Project Road-map:
-----------------
We are planning to develop and add the following features to the project:

1. Fast Link Adaptation.
2. Reverse Direction Protocol (RDP).
3. Statistical Channel Model + Raytracing Model for Millimeter-Wave Band.
4. Complex error model for 802.11ad transmission modes.

If you are willing to work on one of the previous features, we are happy to collaborate.



Building The Project:
---------------------
The current implementation is based on ns3-26. In order to save time and evaluate the IEEE 802.11ad model only, type the following command:

./waf configure --disable-examples --disable-tests --disable-python --enable-modules='applications','core','internet','point-to-point','wifi'
./waf build

The previous command builds the required models only to run IEEE 802.11ad with its provided scripts in debug mode. 

To build the project in optimized mode for fast execution type the following command:

./waf configure --disable-examples --disable-tests --disable-python --enable-modules='applications','core','internet','point-to-point','wifi' --enable-static -d optimized
./waf build



Running Scripts:
----------------
The project includes different scripts located in scratch folder to test the previous listed features and mechanisms. 
At the beginning of each script, there is a some regarding the simulated scenario (network topology + expected output + usage description).



Bug Reporting:
--------------
In case of a bug, please report the problem to the following email address (hany.assasa@gmail.com). 
In the email, please include the following:

1. Simulation file with small description on the simulated scenario and the expected output.
2. Exact run parameters which caused the simulation to crash.

Please do not report any problem related to your own modification of the original code.



About the Model:
----------------
The model is developed and maintained by Hany Assasa. For more information about the author research,
please check his personal website on: http://people.networks.imdea.org/~hany_assasa/