30 #include <ns3/uinteger.h>
47 m_servingCellThreshold (30),
48 m_neighbourCellOffset (1),
49 m_handoverManagementSapUser (0)
65 static TypeId tid =
TypeId (
"ns3::A2A4RsrqHandoverAlgorithm")
69 .AddAttribute (
"ServingCellThreshold",
70 "If the RSRQ of the serving cell is worse than this "
71 "threshold, neighbour cells are consider for handover. "
72 "Expressed in quantized range of [0..34] as per Section "
73 "9.1.7 of 3GPP TS 36.133.",
76 MakeUintegerChecker<uint8_t> (0, 34))
77 .AddAttribute (
"NeighbourCellOffset",
78 "Minimum offset between the serving and the best neighbour "
79 "cell to trigger the handover. Expressed in quantized "
80 "range of [0..34] as per Section 9.1.7 of 3GPP TS 36.133.",
83 MakeUintegerChecker<uint8_t> ())
110 NS_LOG_LOGIC (
this <<
" requesting Event A2 measurements"
120 NS_LOG_LOGIC (
this <<
" requesting Event A4 measurements"
121 <<
" (threshold=0)");
151 "Invalid UE measurement report");
159 for (std::list <LteRrcSap::MeasResultEutra>::iterator it = measResults.
measResultListEutra.begin ();
164 "RSRQ measurement is missing from cellId " << it->physCellId);
170 NS_LOG_WARN (
this <<
" Event A4 received without measurement results from neighbouring cells");
183 uint8_t servingCellRsrq)
187 MeasurementTable_t::iterator it1;
192 NS_LOG_WARN (
"Skipping handover evaluation for RNTI " << rnti <<
" because neighbour cells information is not found");
197 NS_LOG_LOGIC (
"Number of neighbour cells = " << it1->second.size ());
198 uint16_t bestNeighbourCellId = 0;
199 uint8_t bestNeighbourRsrq = 0;
200 MeasurementRow_t::iterator it2;
201 for (it2 = it1->second.begin (); it2 != it1->second.end (); ++it2)
203 if ((it2->second->m_rsrq > bestNeighbourRsrq)
206 bestNeighbourCellId = it2->first;
207 bestNeighbourRsrq = it2->second->m_rsrq;
212 if (bestNeighbourCellId > 0)
214 NS_LOG_LOGIC (
"Best neighbour cellId " << bestNeighbourCellId);
218 NS_LOG_LOGIC (
"Trigger Handover to cellId " << bestNeighbourCellId);
219 NS_LOG_LOGIC (
"target cell RSRQ " << (uint16_t) bestNeighbourRsrq);
220 NS_LOG_LOGIC (
"serving cell RSRQ " << (uint16_t) servingCellRsrq);
224 bestNeighbourCellId);
254 MeasurementTable_t::iterator it1;
261 std::pair<MeasurementTable_t::iterator, bool> ret;
269 std::map<uint16_t, Ptr<UeMeasure> >::iterator it2;
270 it2 = it1->second.find (cellId);
272 if (it2 != it1->second.end ())
274 neighbourCellMeasures = it2->second;
275 neighbourCellMeasures->m_cellId = cellId;
276 neighbourCellMeasures->m_rsrp = 0;
277 neighbourCellMeasures->m_rsrq = rsrq;
282 neighbourCellMeasures = Create<UeMeasure> ();
283 neighbourCellMeasures->m_cellId = cellId;
284 neighbourCellMeasures->m_rsrp = 0;
285 neighbourCellMeasures->m_rsrq = rsrq;
286 it1->second[cellId] = neighbourCellMeasures;
virtual void DoInitialize(void)
Initialize() implementation.
Smart pointer class similar to boost::intrusive_ptr.
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by "...
The abstract base class of a handover algorithm that operates using the Handover Management SAP inter...
#define NS_OBJECT_ENSURE_REGISTERED(type)
Register an Object subclass with the TypeId system.
MeasurementTable_t m_neighbourCellMeasures
Table of measurement reports from all UEs.
virtual void SetLteHandoverManagementSapUser(LteHandoverManagementSapUser *s)
Set the "user" part of the Handover Management SAP interface that this handover algorithm instance wi...
LteHandoverManagementSapProvider * m_handoverManagementSapProvider
Receive API calls from the eNodeB RRC instance.
enum ns3::LteRrcSap::ReportConfigEutra::@70 eventId
Choice of E-UTRA event triggered reporting criteria.
std::list< MeasResultEutra > measResultListEutra
ThresholdEutra threshold1
Threshold for event A1, A2, A4, and A5.
Specifies criteria for triggering of an E-UTRA measurement reporting event.
virtual LteHandoverManagementSapProvider * GetLteHandoverManagementSapProvider()
Export the "provider" part of the Handover Management SAP interface.
virtual void TriggerHandover(uint16_t rnti, uint16_t targetCellId)=0
Instruct the eNodeB RRC entity to prepare a handover.
#define NS_ASSERT(condition)
At runtime, in debugging builds, if this condition is not true, the program prints the source file...
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
A2A4RsrqHandoverAlgorithm()
Creates an A2-A4-RSRQ handover algorithm instance.
Handover algorithm implementation based on RSRQ measurements, Event A2 and Event A4.
virtual ~A2A4RsrqHandoverAlgorithm()
uint8_t m_neighbourCellOffset
The NeighbourCellOffset attribute.
bool IsValidNeighbour(uint16_t cellId)
Determines if a neighbour cell is a valid destination for handover.
void DoReportUeMeas(uint16_t rnti, LteRrcSap::MeasResults measResults)
Implementation of LteHandoverManagementSapProvider::ReportUeMeas.
static TypeId GetTypeId()
LteHandoverManagementSapUser * m_handoverManagementSapUser
Interface to the eNodeB RRC instance.
virtual void DoInitialize()
Initialize() implementation.
Hold an unsigned integer type.
Template for the implementation of the LteHandoverManagementSapProvider as a member of an owner class...
#define NS_LOG_LOGIC(msg)
Use NS_LOG to output a message of level LOG_LOGIC.
uint8_t m_servingCellThreshold
The ServingCellThreshold attribute.
Event A2: Serving becomes worse than absolute threshold.
bool haveMeasResultNeighCells
uint8_t range
Value range used in RSRP/RSRQ threshold.
Reference Signal Received Quality.
enum ns3::LteRrcSap::ReportConfigEutra::@72 triggerQuantity
The quantities used to evaluate the triggering condition for the event, see 3GPP TS 36...
uint8_t m_a2MeasId
The expected measurement identity for A2 measurements.
#define NS_ASSERT_MSG(condition, message)
At runtime, in debugging builds, if this condition is not true, the program prints the message to out...
#define NS_LOG_WARN(msg)
Use NS_LOG to output a message of level LOG_WARN.
Service Access Point (SAP) offered by the handover algorithm instance to the eNodeB RRC instance...
enum ns3::LteRrcSap::ThresholdEutra::@68 choice
void UpdateNeighbourMeasurements(uint16_t rnti, uint16_t cellId, uint8_t rsrq)
Called when Event A4 is reported, then update the measurements table.
enum ns3::LteRrcSap::ReportConfigEutra::@74 reportInterval
Indicates the interval between periodical reports.
virtual uint8_t AddUeMeasReportConfigForHandover(LteRrcSap::ReportConfigEutra reportConfig)=0
Request a certain reporting configuration to be fulfilled by the UEs attached to the eNodeB entity...
Event A4: Neighbour becomes better than absolute threshold.
std::map< uint16_t, Ptr< UeMeasure > > MeasurementRow_t
Measurements reported by a UE for several cells.
void EvaluateHandover(uint16_t rnti, uint8_t servingCellRsrq)
Called when Event A2 is detected, then trigger a handover if needed.
uint8_t m_a4MeasId
The expected measurement identity for A4 measurements.
Ptr< const AttributeAccessor > MakeUintegerAccessor(T1 a1)
Create an AttributeAccessor for a class data member, or a lone class get functor or set method...
virtual void DoDispose()
Destructor implementation.
a unique identifier for an interface.
TypeId SetParent(TypeId tid)
Set the parent TypeId.
Service Access Point (SAP) offered by the eNodeB RRC instance to the handover algorithm instance...
RSRQ is used for the threshold.