From 6117f884d35ad0cc3f57da149f44f32bae2feccc Mon Sep 17 00:00:00 2001
From: Marco Miozzo <marco.miozzo@cttc.es>
Date: Fri, 19 Oct 2012 12:09:01 +0200
Subject: [PATCH] Update HARQ Design documentation with final implementation
 issues

---
 .../source/figures/lte-harq-architecture.dia  | Bin 3356 -> 3361 bytes
 src/lte/doc/source/lte-design.rst             |  21 +++++++++++-------
 2 files changed, 13 insertions(+), 8 deletions(-)

diff --git a/src/lte/doc/source/figures/lte-harq-architecture.dia b/src/lte/doc/source/figures/lte-harq-architecture.dia
index b80c6901f796f44bdc434be94e0e4ee3320140d9..e2ed9549d1a3e65976b87000d8ccbe23b4d90a85 100644
GIT binary patch
delta 3360
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

delta 3355
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

diff --git a/src/lte/doc/source/lte-design.rst b/src/lte/doc/source/lte-design.rst
index 8fd0da307..e1483bdab 100644
--- a/src/lte/doc/source/lte-design.rst
+++ b/src/lte/doc/source/lte-design.rst
@@ -580,7 +580,9 @@ Round Robin (RR) Scheduler
 The Round Robin (RR) scheduler is probably the simplest scheduler found in the literature. It works by dividing the
 available resources among the active flows, i.e., those logical channels which have a non-empty RLC queue. If the number of RBGs is greater than the number of active flows, all the flows can be allocated in the same subframe. Otherwise, if the number of active flows is greater than the number of RBGs, not all the flows can be scheduled in a given subframe; then, in the next subframe the allocation will start from the last flow that was not allocated.  The MCS to be adopted for each user is done according to the received wideband CQIs.
 
-For what concern the HARQ, RR implements the non adaptive version, which implies that in allocating the retransmission RR uses a similar allocation configuration of the original block, which means maintaining the same RBGs and MCS. UEs that are allocated for HARQ retransmissions are not considered for the transmission of new data in case they have a transmission opportunity in the same TTI.
+For what concern the HARQ, RR implements the non adaptive version, which implies that in allocating the retransmission RR uses the same allocation configuration of the original block, which means maintaining the same RBGs and MCS. UEs that are allocated for HARQ retransmissions are not considered for the transmission of new data in case they have a transmission opportunity in the same TTI. Finally, HARQ can be disabled with ns3 attribute system for maintaining backward compatibility with old test cases and code, in detail::
+
+  Config::SetDefault ("ns3::RrFfMacScheduler::HarqEnabled", BooleanValue (false));
 
 
 .. only:: latex
@@ -657,7 +659,9 @@ where :math:`|\cdot|` indicates the cardinality of the set; finally,
    \right)}{\tau}
    
 
-*HARQ PF specifications: to be defined*.
+For what concern the HARQ, PF implements the non adaptive version, which implies that in allocating the retransmission the scheduler uses the same allocation configuration of the original block, which means maintaining the same RBGs and MCS. UEs that are allocated for HARQ retransmissions are not considered for the transmission of new data in case they have a transmission opportunity in the same TTI. Finally, HARQ can be disabled with ns3 attribute system for maintaining backward compatibility with old test cases and code, in detail::
+
+  Config::SetDefault ("ns3::PfFfMacScheduler::HarqEnabled", BooleanValue (false));
 
 Transport Blocks
 ----------------
@@ -1575,14 +1579,14 @@ Therefore the PHY layer implements the MIMO model as the gain perceived by the r
 HARQ Model
 ----------
 
-The HARQ scheme implemented is based on a incremental redundancy (IR) solutions combined with multiple stop-and-wait processes for enabling a continuous data flow. In detail, the solution adopted is the *soft combining hybrid IR Full incremental redundancy* (also called IR Type II), which implies that the retransmissions include only new information. The resource allocation algorithm of the HARQ has been implemented within the respective schedulers class (i.e., ``RrFfMacScheduler`` and ``PfFfMacScheduler``, refer to their respective sections for more info), while the decodification part of the HARQ has been implemented in the ``LteSpectrumPhy`` class which will be detailed in this section.
+The HARQ scheme implemented is based on a incremental redundancy (IR) solutions combined with multiple stop-and-wait processes for enabling a continuous data flow. In detail, the solution adopted is the *soft combining hybrid IR Full incremental redundancy* (also called IR Type II), which implies that the retransmissions contain only new information respect to the previous ones. The resource allocation algorithm of the HARQ has been implemented within the respective scheduler classes (i.e., ``RrFfMacScheduler`` and ``PfFfMacScheduler``, refer to their respective sections for more info), while the decodification part of the HARQ has been implemented in the ``LteSpectrumPhy`` and ``LteHarqPhy`` classes which will be detailed in this section.
 
 According to the standard, the UL retransmissions are synchronous and therefore are allocated 7 ms after the original transmission. On the other hand, for the DL, they are asynchronous ans therefore can be allocated in a more flexible way starting from 7 ms and it is a matter of the specific scheduler implementation. The HARQ processes behavior is depicted in Figure:ref:`fig-harq-processes-scheme`.
 
-At the MAC layer, the HARQ entity residing in the scheduler is in charge of controlling the 8 HARQ processes for generating new packets and managing the retransmissions both for the DL and the UL. The scheduler collects the HARQ feedback from eNB and UE PHY layers (respectively UL and DL connection) by means of the FF API primitives ``SchedUlTriggerReq`` and ``SchedUlTriggerReq``, and stores them in a FIFO buffer for maintaining the order of arrival. According to the HARQ feedback and the RLC buffers status, the scheduler generates a set of DCIs including both retransmissions of HARQ blocks received erroneous and new transmissions, in general, giving priority to the former. On this matter, the scheduler has to take into consideration one constraint when allocating the resource for HARQ retransmissions, it must use the same modulation order of the first transmission attempt (i.e., QPSK for MCS :math:`\in [0..9]`, 16QAM for MCS :math:`\in [10..16]` and 64QAM for MCS :math:`\in [17..28]`). This restriction comes from the specification of the rate matcher in the 3GPP standard [TS36212]_, where for generating the different TBs of the redundancy version the algorithm fixes the modulation order.
+At the MAC layer, the HARQ entity residing in the scheduler is in charge of controlling the 8 HARQ processes for generating new packets and managing the retransmissions both for the DL and the UL. The scheduler collects the HARQ feedback from eNB and UE PHY layers (respectively for UL and DL connection) by means of the FF API primitives ``SchedUlTriggerReq`` and ``SchedUlTriggerReq``, and stores them in a FIFO buffer for maintaining the order of arrival. According to the HARQ feedback and the RLC buffers status, the scheduler generates a set of DCIs including both retransmissions of HARQ blocks received erroneous and new transmissions, in general, giving priority to the former. On this matter, the scheduler has to take into consideration one constraint when allocating the resource for HARQ retransmissions, it must use the same modulation order of the first transmission attempt (i.e., QPSK for MCS :math:`\in [0..9]`, 16QAM for MCS :math:`\in [10..16]` and 64QAM for MCS :math:`\in [17..28]`). This restriction comes from the specification of the rate matcher in the 3GPP standard [TS36212]_, where the algorithm fixes the modulation order for generating the different TBs of the redundancy versions.
 
 
-The PHY Error Model model has been extended for considering IR HARQ according to [wimaxEmd]_, where the parameters for the AWGN curves mapping for MIESM mapping in case of retransmissions are given by:
+The PHY Error Model model (i.e., the ``LteMiErrorModel`` class already presented before) has been extended for considering IR HARQ according to [wimaxEmd]_, where the parameters for the AWGN curves mapping for MIESM mapping in case of retransmissions are given by:
 
 .. math::
 
@@ -1590,8 +1594,8 @@ The PHY Error Model model has been extended for considering IR HARQ according to
 
     M_{I eff} = \frac{\sum\limits_{i=1}^q C_i M_i}{\sum\limits_{i=1}^q C_i}
 
-where :math:`X` is the number of original information bits, :math:`C_i` are number of coded bits, :math:`M_i` are the mutual informations per HARQ block received on the total number of :math:`q` retransmissions. Therefore, in order to be able to return the error probability with the error model implemented in the simulator evaluates the :math:`R_{eff}` and the :math:`MI_{I eff}` and return the value of error probability of the ECR of the same modulation with closest rate respect to the :math:`R_{eff}`. In order to consider the effect of HARQ retransmissions a new sets of curves have been integrated respect to the standard one used for the original MCS, especially for covering the cases when the most conservative MCS of a modulation is used. On this matter the curves for 1, 2 and 3 retransmissions have been evaluated for MCS 0, 10 and 17.
-It is to be noted that, the first tranmission has been assumed as containing all the information bits to be coded; therefore :math:`X` is equal to the size of the first TB sent of a an HARQ process.
+where :math:`X` is the number of original information bits, :math:`C_i` are number of coded bits, :math:`M_i` are the mutual informations per HARQ block received on the total number of :math:`q` retransmissions. Therefore, in order to be able to return the error probability with the error model implemented in the simulator evaluates the :math:`R_{eff}` and the :math:`MI_{I eff}` and return the value of error probability of the ECR of the same modulation with closest lower rate respect to the :math:`R_{eff}`. In order to consider the effect of HARQ retransmissions a new sets of curves have been integrated respect to the standard one used for the original MCS, especially for covering the cases when the most conservative MCS of a modulation is used. On this matter the curves for 1, 2 and 3 retransmissions have been evaluated for MCS 0, 10 and 17.
+It is to be noted that, the first transmission has been assumed as containing all the information bits to be coded; therefore :math:`X` is equal to the size of the first TB sent of a an HARQ process.
 
 
 .. _fig-harq-processes-scheme:
@@ -1603,8 +1607,9 @@ It is to be noted that, the first tranmission has been assumed as containing all
 
 
 
-This part of HARQ devoted to manage the decodification of the HARQ blocks has been implemented in the ``LteSpectrumPhy`` class, where it has been also included the messaging algorithm in charge of communicating to the HARQ in the scheduler the result of the decodifications. These messages are encapsulated in the ``dlInfoListElement`` for DL and ``ulInfoListElement`` for UL and sent through the PUCCH and the PHICH respectively in an ideal error free way according to the assumptions in their implementation. A sketch of the iteration between HARQ and LTE protocol stack in represented in Figure:ref:`fig-harq-architecture`.
+The part of HARQ devoted to manage the decodification of the HARQ blocks has been implemented in the ``LteHarqPhy`` and ``LteSpectrumPhy`` classes. The former is in charge of maintaing the HARQ information for each active process . The latter interacts with ``LteMiErrorModel`` class for evaluating the correctness of the blocks received and includes the messaging algorithm in charge of communicating to the HARQ in the scheduler the result of the decodifications. These messages are encapsulated in the ``dlInfoListElement`` for DL and ``ulInfoListElement`` for UL and sent through the PUCCH and the PHICH respectively in an ideal error free way according to the assumptions in their implementation. A sketch of the iteration between HARQ and LTE protocol stack in represented in Figure:ref:`fig-harq-architecture`.
 
+Finally, the HARQ engine is always active both at MAC and PHY layer; however, in case of the scheduler does not support HARQ the system will continue to work with the HARQ functions inhibited (i.e., buffers are filled but not used). This implementation characteristic gives backward compatibility with schedulers implemented before HARQ integration. 
 
 
 .. _fig-harq-architecture: