--- a/src/laa-wifi-coexistence/doc/Makefile Mon Apr 27 18:15:11 2015 +0200
+++ b/src/laa-wifi-coexistence/doc/Makefile Mon Apr 27 18:15:32 2015 +0200
@@ -11,7 +11,7 @@
# specify dia figures from which .png and .pdf figures need to be built
IMAGES_DIA = \
-# $(FIGURES)/figure-name.dia \
+ $(FIGURES)/lte-unlicensed-interference-test-scenario.dia
# specify eps figures from which .png and .pdf figures need to be built
@@ -21,7 +21,7 @@
# rescale pdf figures as necessary
-#$(FIGURES)/figure-name.pdf_width = 8cm
+$(FIGURES)/lte-unlicensed-interference-test-scenario.pdf_width = 8cm
Binary file src/laa-wifi-coexistence/doc/source/figures/lte-unlicensed-interference-test-scenario.dia has changed
--- a/src/laa-wifi-coexistence/doc/source/laa-wifi-coexistence.rst Mon Apr 27 18:15:11 2015 +0200
+++ b/src/laa-wifi-coexistence/doc/source/laa-wifi-coexistence.rst Mon Apr 27 18:15:32 2015 +0200
@@ -11,14 +11,16 @@
############# Paragraph (no number)
-The LAA Wi-Fi Coexistence module provides support to simulate with |ns3| the scenarios for
-the coextistence between LTE License Assisted Access (LAA) and Wi-Fi
-systems, following the description in [TR36889]_.
Model Description
*****************
+
+The LAA Wi-Fi Coexistence module provides support to simulate with |ns3| the scenarios for
+the coextistence between LTE License Assisted Access (LAA) and Wi-Fi
+systems, following the description in [TR36889]_.
+
The support for simulating the LTE and Wi-Fi technology is provided by the
separate |ns3| LTE and Wi-Fi module; the LAA Wi-Fi Coexistence module focuses on the
additional features that are needed to create a simulation scenario
@@ -95,9 +97,54 @@
Add any tips for avoiding pitfalls, etc.
+
+
+
Validation
**********
-Describe how the model has been tested/validated. What tests run in the
-test suite? How much API and code is covered by the tests? Again,
-references to outside published work may help here.
+In the following we describe the test suites that are provided along
+with the code of the laa-wifi-coexistence module and validate its
+proper functionality and correct simulation output in some key
+configurations for which the intended behavior and output can be
+determined a priori.
+
+LTE unlicensed interference test
+================================
+
+The test suite `lte-unlicensed-interference` aims at verifying the
+correct behavior and simulation output of the LTE PHY and, in
+particular, of its interference model, in presence of non-LTE
+interferes. The topology of the test is depicted in Figure
+:ref:`fig-lte-unlicensed-interference-test-scenario`, and involves an
+LTE eNB, an LTE UE attached to it, and a non-LTE interferer
+implemented using the WaveformGenerator class. The LTE downlink is
+configured in the 5GHz bandwidth where the intenterference also takes
+place. The waveform generator is configured to transmit
+continuously at constant power. The :math:`d_1` parameter represents the distance of each UE to the eNB it
+is attached to, whereas the :math:`d_2` parameter represent the
+interferer distance; different test cases are generated changing the
+values of the parameters.
+
+The following conditions are verified:
+
+ - the SINR calculated at the UE is equal to the expected one within a
+ tolerance of :math:`0.01` dB
+
+ - the MCS used for transmission by the eNB is exactly the expected
+ one
+
+The reference values are calculated using the octave script
+`lte_link_budget_unlicensed_interference.m` which can be found in
+`src/laa-wifi-coexistence/test/reference/`
+
+
+.. _fig-lte-unlicensed-interference-test-scenario:
+
+.. figure:: figures/lte-unlicensed-interference-test-scenario.*
+ :align: center
+
+ Topology of the LTE unlicensed interference test
+
+
+