GSOC2018Coexistence

From Nsnam
Revision as of 03:15, 5 May 2018 by Muh.iqbal.cr (Talk | contribs)

Jump to: navigation, search

Main Page - Current Development - Developer FAQ - Tools - Related Projects - Project Ideas - Summer Projects

Installation - Troubleshooting - User FAQ - HOWTOs - Samples - Models - Education - Contributed Code - Papers

Return to GSoC 2018 Accepted Projects page.

Project overview

  • Project name: Merging and Improvement of LTE and Wi-Fi Coexistence Module
  • Abstract: The LTE and Wi-Fi Coexistence Module which implements 3GPP specification of License Assisted Access (LAA) and the interfacing of LTE and Wi-Fi module in ns-3, has been quite popular with ns-3 users. Works has been done to implement the LTE and Wi-Fi Coexistence Module. But currently it is far removed from the mainline development and missing improvements that has been implemented on the upstream. It is hard to apply patch from it, and inversely, merge the module to it. Moreover, it is also created to implement TR 36.889 test scenarios, making it difficult to customize for other cases. Furthermore, more improvement ideas can be implemented to streamline and improve readability of the simulation scenario. Some key features missing from the unit test (e.g., LAA backoff), will also be implemented. The goal will be successfully merging the existing works to ns-3-dev, improving the flexibility of scenario deployment, and improving usability in terms of getting more useful data out of the simulations.
  • Code: TBD
  • Documentation: TBD
  • About me: I am an admitted student of the Computer Science Departement of University of Chicago starting next September. Previously, I did my Master Studies at the National Taiwan University of Science and Technology (NTUST), Taiwan. Since my current research focus is on the LTE and Wi-Fi Coexistence, I have taken a large interest in improving the module. I have been working with Tom Henderson for quite some time to merge the module to the upstream, and doing it under GSoC wil hopefully accelerate the progress.

Technical Approach

The development LTE and Wi-Fi Coexistence Module depends on the modification of LTE and Wi-Fi modules. Therefore, modifications to LTE and Wi-Fi modules are needed to make them compatible to the coexistence module. After the preliminary modifications, the next step will be merging the current available work of ns-3-lbt repository along with improvements.

The current LTE and Wi-Fi Coexistence Module consist of the usual components (i.e., documentations, user examples, helpers, models, and tests) with an addition of experiments component which holds run and plot scripts for 3GPP TR 36.889 test cases. The test scenario for TR 36.889 itself are written in user examples component. Because the test cases are similar, those test scenarios are calling ScenarioHelper class in the helper component to set up everything. It is very helpful for users but since they are relying on it, they need to modify it if they want to create a scenario that very differ to the TR 36.889's. Therefore, an improvement to limit the responsibility of ScenarioHelper is proposed. ScenarioHelper should only responsible of setting up scenario, nodes, and logging. By limiting its responsibility, users can modify much more parameters from their own scenario, such as:

  • The number of cell group (currently only two cell groups).
  • Different application starting time for each cell.
  • Granularly control each node's parameter (e.g., LBT TXOP, Minimum and Maximum CW).

Milestones and Deliverables

The entire GSoC period is divided into 3 phases. The deliverables at the end of each phase is as mentioned below:

Phase 1: Preliminary works

  • Preliminary modification of LTE and Wi-Fi modules to prepare for the LTE and Wi-Fi Coexistence module.
  • Implementation of FileTransferApplication according to previous works with the addition of FileSrc attribute for adding file input.

Phase 2: Merge

  • Implementation of the restructured ScenarioHelper.
  • Merging the rest of the previous works into the new repository.

Phase 3: Finalize

  • Implementation of the missing unit tests (LBT channel manager, LAA backoff).
  • API and web page documentation.
  • Fixes for old bugs that was previously found the old repository, if it still not fixed by the merge.

Weekly Reports