Skip to content

Home

Jump to bottom
Hany Assasa edited this page Feb 9, 2018 · 32 revisions

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. DMG PLCP Model for 802.11ad frame transmission and reception.
  4. Abstract DMG PHY layer for DMG CTRL/SC/OFDM.
  5. 60 GHz Directional Antenna Model.
  6. Fast Session Transfer (FST) Mechanism.
  7. DMG Relay Support (Full Duplex and Half Duplex Modes).
  8. Dynamic Channel Allocation (Polling).
  9. Service Period Allocation.
  10. Beamformed Link Maintenance.
  11. Decentralized Clustering.
  12. Spatial Sharing and Interference Assessment.

Acknowledgment:

The implementation is based on the existing model of the 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

@inproceedings{Assasa:2016:IEW:2915371.2915377,
 author = {Assasa, Hany and Widmer, Joerg},
 title = {Implementation and Evaluation of a WLAN IEEE 802.11Ad Model in Ns-3},
 booktitle = {Proceedings of the Workshop on Ns-3},
 series = {WNS3 '16},
 year = {2016},
 isbn = {978-1-4503-4216-2},
 location = {Seattle, WA, USA},
 pages = {57--64},
 numpages = {8},
 url = {http://doi.acm.org/10.1145/2915371.2915377},
 doi = {10.1145/2915371.2915377},
 acmid = {2915377},
 publisher = {ACM},
 address = {New York, NY, USA},
 keywords = {60 GHz, IEEE 802.11ad, Millimeter Wave, ns-3},
}

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

@inproceedings{Assasa:2017:EIM:3067665.3067667,
 author = {Assasa, Hany and Widmer, Joerg},
 title = {Extending the IEEE 802.11Ad Model: Scheduled Access, Spatial Reuse, Clustering, and Relaying},
 booktitle = {Proceedings of the Workshop on Ns-3},
 series = {WNS3 '17},
 year = {2017},
 isbn = {978-1-4503-5219-2},
 location = {Porto, Portugal},
 pages = {39--46},
 numpages = {8},
 url = {http://doi.acm.org/10.1145/3067665.3067667},
 doi = {10.1145/3067665.3067667},
 acmid = {3067667},
 publisher = {ACM},
 address = {New York, NY, USA},
 keywords = {60 GHz, IEEE 802.11ad, Millimeter Wave, WiGig, ns-3},
}

Project Road-map:

We are planning to develop and add the following features to the project:

  1. Codebook design for supporting multiple-phased antenna array per device. The codebook
  2. Load custom radiation patterns generated using Matlab Phased Antenna Array Toolbox for sector directivity.
  3. Accurate error models (BER-SNR lookup table for different Modulation and Coding Schemes).
  4. Enchaining beamforming state machine.
  5. Reverse Direction Protocol (RDP) for bi-directional transmission in SP allocation or TxOP allocation..
  6. Fast Link Adaptation.
  7. Statistical Channel Model and Ray-tracing Model for Millimeter-Wave Band.

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

Limitation:

Below is a list of the limitation in the code:

  1. Data communication in SP allocation does not support A-MPDU aggregation and only A-MSDU aggregation. The reason is A-MPDU aggregation requires establishing Block Acknowledgement agreement between the initiator and the responder which requires a bi-directional transmission in the SP allocation. However, communication in SP is only allowed in uni-directional way. To solve the previous problem, Reverse Directional Protocol is required.
  2. The current implementation does not support Multi-AP operation using CSMA/CA. To support Multi-AP scenario, you need to enable Decentralized clustering.
  3. Not all the features have been tested in complex scenarios. In case, you run into bug feel free to report it.

Prerequisites:

Before start using the 802.11ad model, please keep the following in mind:

  1. Understand WLAN IEEE 802.11 MAC/PHY operations. There are plenty of references on the Internet describing CSMA/CA protocol and the evolution of 802.11 protocol.
  2. Get familiar with ns-3 and how to run simulations in ns-3. Have a look on the tutorial page of the simulator.
  3. Understand the existing Wifi Model in ns-3 which implements WLAN IEEE 802.11a/b/g/n/ac/ax.
  4. Finally, do not contact me asking how to use the model or provide you with some documentations on how to use ns-3. Simply, I will ignore your email :)

Once you have completed all these steps, you can proceed with my model.

Building The Project:

The current implementation is based on ns3-26. As I changed some of the APIs for both Mesh and Wifi modules, you should disable building their corresponding examples and tests otherwise the build will fail. 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, I include some description regarding the tested feature, network topology, expected output, and usage method.

Reporting:

In case you come across a bug during the usage of the original model, 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.

Author Information:

The model is developed and maintained by Hany Assasa. For more information about the author research, please check his personal website.

Clone this wiki locally