From 54947ecb229f52d5dcb89cf99cd650bd9e186477 Mon Sep 17 00:00:00 2001
From: Budiarto Herman <budiarto.herman@magister.fi>
Date: Fri, 13 Dec 2013 10:50:45 +0100
Subject: [PATCH] updated RELEASE_NOTES and CHANGES.html with GSoC 2013 LTE
 details

---
 CHANGES.html  | 48 ++++++++++++++++++++++++++++++++++++++++++++++--
 RELEASE_NOTES | 10 ++++++++++
 2 files changed, 56 insertions(+), 2 deletions(-)

diff --git a/CHANGES.html b/CHANGES.html
index ef52f0a3b..7b52daef4 100644
--- a/CHANGES.html
+++ b/CHANGES.html
@@ -75,6 +75,38 @@ us a note on ns-developers mailing list.</p>
     it can be used over other NetDevices. See the manual for
     further discussion.
   </li>
+  <li> LteHelper has been updated with some new APIs:
+    <ul>
+      <li>new overloaded Attach methods to enable UE to automatically determine
+          the eNodeB to attach to (using initial cell selection);</li>
+      <li>new methods related to handover algorithm: SetHandoverAlgorithmType
+          and SetHandoverAlgorithmAttribute;</li>
+      <li>a new attribute AnrEnabled to activate/deactivate Automatic Neighbour
+          Relation (ANR) function; and</li>
+      <li>a new method SetUeDeviceAttribute for configuring LteUeNetDevice.</li>
+    </ul>
+  </li>
+  <li> The GSoC 2013 project in the LTE module has brought some additional APIs:
+    <ul>
+      <li>a new abstract class LteHandoverAlgorithm, which every future
+          implementation of automatic handover trigger should inherit from;</li>
+      <li>new classes LteHandoverAlgorithm and LteAnr as sub-modules of
+          LteEnbNetDevice class; both interfacing with the LteEnbRrc sub-module
+          through Handover Management SAP and ANR SAP;</li>
+      <li>new attributes in LteEnbNetDevice and LteUeNetDevice classes related
+          to Closed Subscriber Group (CSG) functionality in initial cell
+          selection;</li>
+      <li>new attributes in LteEnbRrc for configuring UE measurements' filtering
+          coefficient (i.e., quantity configuration);</li>
+      <li>a new public method AddUeMeasReportConfig in LteEnbRrc for setting up
+          custom UE measurements' reporting configuration; measurement reports
+          can then be captured from the RecvMeasurementReport trace source;
+          and</li>
+      <li>new trace sources in LteUeRrc to capture more events, such as System
+          Information messages (MIB, SIB1, SIB2), initial cell selection, random
+          access, and handover.</li>
+    </ul>
+  </li>
 </ul>
 
 <h2>Changes to existing API:</h2>
@@ -92,10 +124,22 @@ us a note on ns-developers mailing list.</p>
       EpcHelper is just the base class defining the API, and the
       implementation has been moved to derived classes; as such,
       users are now expected to use one of the derived classes in
-      their simulation program. The imlpementation previously
+      their simulation program. The implementation previously
       provided by the EpcHelper class has been moved to the new
       derived class PointToPointEpcHelper.</li>
- </ul>
+  <li> The automatic handover trigger and ANR functions in LTE module have been
+    moved from LteEnbRrc class to separate classes. As a result, the related
+    attributes, e.g., ServingCellHandoverThreshold, NeighbourCellHandoverOffset,
+    EventA2Threshold, and EventA4Threshold have been removed from LteEnbRrc
+    class. The equivalent attributes are now in A2A4RsrqHandoverAlgorithm and
+    LteAnr classes.</li>
+  <li> Master Information Block (MIB) and System Information Block Type 1 (SIB1)
+    are now transmitted as LTE control messages, so they are no longer part of
+    RRC protocol.</li>
+  <li> UE RRC state model in LTE module has been considerably modified and is
+    not backward compatible with the previous state model.</li>
+</ul>
+
 <h2>Changes to build system:</h2>
 
 <h2>Changed behavior:</h2>
diff --git a/RELEASE_NOTES b/RELEASE_NOTES
index 09ee648c2..17985318d 100644
--- a/RELEASE_NOTES
+++ b/RELEASE_NOTES
@@ -45,6 +45,16 @@ New user-visible features
   switching between control and service channels, or using multiple radios, are
   not yet modelled.
 
+- Extension to UE measurements and improved handover algorithm models in LTE
+  module, as the outcome of GSoC 2013 project. The project also includes several
+  sub-features, such as:
+   - implementation of System Information Block Type 1 (SIB1);
+   - a new option for automatic UE attachment using Idle mode cell selection
+     procedure;
+   - improved configurability of UE measurements; and
+   - two options of handover algorithms for enabling automatic handover trigger
+     in LTE simulation: A2-A4-RSRQ and strongest cell (A3-RSRP).
+
 Bugs fixed
 ----------
 - Bug 1496 - Option to print log level in NS_LOG messages, and documentation.