1
2+++++++++++++++++++++++++++++++++++++
3 RELEASE NOTES of the ns-3 LTE module
4+++++++++++++++++++++++++++++++++++++
5
6This file documents the user-visible features that have been added
7within each release of the ns-3 LTE module.
8
9
10Milestone 6 (M6) release of the LENA project (April 30, 2013)
11================================================================
12
13 - PHY support for UE measurements (RSRP and RSRQ)
14 - RRC support for UE measurements (configuration, execution, reporting)
15 - Automatic Handover trigger based on RRC UE measurement reports
16
17
18Milestone 5 (M5) release of the LENA project (January 23, 2013)
19================================================================
20
21 - MIMO model
22 - HARQ model integrated with error model
23 - Control Channel and Reference Signals models
24 - MAC Random Access model with protocol interference model
25   for preamble collisions
26 - RRC implementation with new UE and ENB state machines and
27   ASN.1-encoded RRC PDUs sent over Signaling Radio Bearers
28 - RLC TM model
29 - MME, S1-AP and S11 logical models
30 - X2 implementation supporting handover and SON primitives
31 - additional KPIs: RSRP & SINR traces, PHY tx/rx traces,
32   SRB stats
33 - several bug fixes
34
35
36GSoC 2012 release (merged into ns-3-dev on December 2012)
37=========================================================
38
39 - Maximum Throughput (MT) Scheduler
40 - Throughput to Average (TTA) Scheduler
41 - Blind Equal Throughput (BET) Scheduler
42 - Token Bank Fair Queue (TBFQ) Scheduler
43 - Priority Set Scheduler (PSS)
44
45
46Milestone 4 (M4) release of the LENA project (December 15, 2011)
47================================================================
48
49+ LTE Radio Protocols:
50  - RLC/UM
51  - RLC/AM
52  - PDCP
53+ EPC data plane:
54  - S1-U interface with GTP-U tunneling
55  - SGW/PGW node
56  - TFT classifiers
57  - mapping of EPS bearers to Radio Bearers
58  - integration with ns-3 Ipv4 and ns-3 applications
59+ Propagation Models:
60  - revised trace-based fading model with new traces
61  - new buildings pathloss model
62
63
64Milestone 1 (M1) release of the LENA project (June 17, 2011)
65============================================================
66
67Here is a summary of the new features available in the LTE module with
68this release:
69
70
71 - uplink PHY and MAC properly implemented including Adaptive
72   Modulation and Coding (previously only downlink was supported)
73
74 - interference modeling was implemented: it is now possible to
75   simulate multi-cell scenarios with inter-cell interference
76
77 - flexible spectrum model: it is now possible to specify the carrier
78   frequency and bandwidth of each cell independently
79
80 - an implementation of the Proportional Fair scheduler based on the
81   FF LTE MAC Scheduler API is now included
82
83 - support for output of RLC and MAC layer Key Performance Indicators
84   (KPIs) via dedicated trace sinks connected to newly defined trace
85   sources
86
87 - the setting of the most relevant parameters (e.g. tx power, noise,
88   carrier frequency, bandwidth, type of scheduler, etc.) is now done
89   via the ns-3 attribute system
90
91 - several test suites have been added, including both unit tests that
92   check the correct functionality of specific objects, and system
93   tests that validate the output produced by the simulator in several
94   scenarios of interest.
95
96 - the documentation of the lte module has been entirely rewritten, it
97   now features three separate sections: the design documentation, the
98   user documentation and the testing documentation.
99
100
101
102First Public release of the LENA project (March 10, 2011)
103=========================================================
104
105The LENA code is based on the GSoC 2010 project code by Giuseppe Piro,
106which was merged into ns-3-dev on December 2010. With respect to the GSoC
107code, the main modifications that have been performed are:
108
109 - the MAC has been entirely rewritten to support the MAC Scheduler
110   API defined by the Femto Forum, which is publicly available at this
111   location: http://www.femtoforum.org/femto/technical.php
112
113 - a Round Robin scheduler implementation based on the above API is
114   also provided
115
116 - the RLC API has been redefined  RLC in particular, at this stage
117   only the API definition is in place, together with a simplified RLC
118   implementation (RLC TM/UM/AM not available yet)
119
120  - the RRC has been entirely rewritten; we plan to reuse part of the
121    GSoC 2010 flow classification code (which we plan to reuse) at a
122    future stage for the implementation of Traffic Flow Template
123    classifiers.
124
125  - network layer functionality has been temporarily disabled; it will
126    be re-enabled when either RLC/UM or RLC/AM is available.
127
128
129
130
131GSoC 2010 release (merged into ns-3-dev on December 2010)
132=========================================================
133
134Here are
135In summary, the most important features provided by the
136proposed module are (i) a basic implementation of both the
137User Equipment (UE) and the enhanced NodeB (eNB) de-
138vices, (ii) RRC entities for both the UE and the eNB, (iii)
139a state-of-the-art Adaptive Modulation and Coding (AMC)
140scheme for the downlink [9], (iv) the management of the
141data radio bearers (with their QoS parameters), the MAC
142queues and the RLC instances, (v) Channel Quality Indi-
143cator (CQI) management, (vi) support for both uplink and
144downlik packet scheduling, (vii) a PHY layer model with
145Resource Block level granularity and (viii) a channel model
146with the outdoor E-UTRAN propagation loss model.
147
148