19#include <ns3/uinteger.h>
35 : m_servingCellThreshold(30),
36 m_neighbourCellOffset(1),
37 m_handoverManagementSapUser(nullptr)
53 TypeId(
"ns3::A2A4RsrqHandoverAlgorithm")
57 .AddAttribute(
"ServingCellThreshold",
58 "If the RSRQ of the serving cell is worse than this "
59 "threshold, neighbour cells are consider for handover. "
60 "Expressed in quantized range of [0..34] as per Section "
61 "9.1.7 of 3GPP TS 36.133.",
65 .AddAttribute(
"NeighbourCellOffset",
66 "Minimum offset between the serving and the best neighbour "
67 "cell to trigger the handover. Expressed in quantized "
68 "range of [0..34] as per Section 9.1.7 of 3GPP TS 36.133.",
104 NS_LOG_LOGIC(
this <<
" requesting Event A4 measurements"
105 <<
" (threshold=0)");
133 "Invalid UE measurement report");
146 "RSRQ measurement is missing from cellId " << it->physCellId);
153 this <<
" Event A4 received without measurement results from neighbouring cells");
172 NS_LOG_WARN(
"Skipping handover evaluation for RNTI "
173 << rnti <<
" because neighbour cells information is not found");
178 NS_LOG_LOGIC(
"Number of neighbour cells = " << it1->second.size());
179 uint16_t bestNeighbourCellId = 0;
180 uint8_t bestNeighbourRsrq = 0;
181 for (
auto it2 = it1->second.begin(); it2 != it1->second.end(); ++it2)
183 if ((it2->second->m_rsrq > bestNeighbourRsrq) &&
IsValidNeighbour(it2->first))
185 bestNeighbourCellId = it2->first;
186 bestNeighbourRsrq = it2->second->m_rsrq;
191 if (bestNeighbourCellId > 0)
193 NS_LOG_LOGIC(
"Best neighbour cellId " << bestNeighbourCellId);
197 NS_LOG_LOGIC(
"Trigger Handover to cellId " << bestNeighbourCellId);
198 NS_LOG_LOGIC(
"target cell RSRQ " << (uint16_t)bestNeighbourRsrq);
199 NS_LOG_LOGIC(
"serving cell RSRQ " << (uint16_t)servingCellRsrq);
241 auto it2 = it1->second.find(cellId);
243 if (it2 != it1->second.end())
245 neighbourCellMeasures = it2->second;
246 neighbourCellMeasures->m_cellId = cellId;
247 neighbourCellMeasures->m_rsrp = 0;
248 neighbourCellMeasures->m_rsrq = rsrq;
254 neighbourCellMeasures->m_cellId = cellId;
255 neighbourCellMeasures->m_rsrp = 0;
256 neighbourCellMeasures->m_rsrq = rsrq;
257 it1->second[cellId] = neighbourCellMeasures;
Handover algorithm implementation based on RSRQ measurements, Event A2 and Event A4.
static TypeId GetTypeId()
Get the type ID.
LteHandoverManagementSapUser * m_handoverManagementSapUser
Interface to the eNodeB RRC instance.
friend class MemberLteHandoverManagementSapProvider< A2A4RsrqHandoverAlgorithm >
let the forwarder class access the protected and private members
std::map< uint16_t, Ptr< UeMeasure > > MeasurementRow_t
Measurements reported by a UE for several cells.
void DoInitialize() override
Initialize() implementation.
A2A4RsrqHandoverAlgorithm()
Creates an A2-A4-RSRQ handover algorithm instance.
LteHandoverManagementSapProvider * GetLteHandoverManagementSapProvider() override
Export the "provider" part of the Handover Management SAP interface.
LteHandoverManagementSapProvider * m_handoverManagementSapProvider
Receive API calls from the eNodeB RRC instance.
bool IsValidNeighbour(uint16_t cellId)
Determines if a neighbour cell is a valid destination for handover.
std::vector< uint8_t > m_a2MeasIds
The expected measurement identities for A2 measurements.
void UpdateNeighbourMeasurements(uint16_t rnti, uint16_t cellId, uint8_t rsrq)
Called when Event A4 is reported, then update the measurements table.
void DoDispose() override
Destructor implementation.
void SetLteHandoverManagementSapUser(LteHandoverManagementSapUser *s) override
Set the "user" part of the Handover Management SAP interface that this handover algorithm instance wi...
void EvaluateHandover(uint16_t rnti, uint8_t servingCellRsrq)
Called when Event A2 is detected, then trigger a handover if needed.
MeasurementTable_t m_neighbourCellMeasures
Table of measurement reports from all UEs.
~A2A4RsrqHandoverAlgorithm() override
uint8_t m_servingCellThreshold
The ServingCellThreshold attribute.
void DoReportUeMeas(uint16_t rnti, LteRrcSap::MeasResults measResults) override
Implementation of LteHandoverManagementSapProvider::ReportUeMeas.
std::vector< uint8_t > m_a4MeasIds
The expected measurement identities for A4 measurements.
uint8_t m_neighbourCellOffset
The NeighbourCellOffset attribute.
The abstract base class of a handover algorithm that operates using the Handover Management SAP inter...
Service Access Point (SAP) offered by the handover algorithm instance to the eNodeB RRC instance.
Service Access Point (SAP) offered by the eNodeB RRC instance to the handover algorithm instance.
virtual void TriggerHandover(uint16_t rnti, uint16_t targetCellId)=0
Instruct the eNodeB RRC entity to prepare a handover.
virtual std::vector< uint8_t > AddUeMeasReportConfigForHandover(LteRrcSap::ReportConfigEutra reportConfig)=0
Request a certain reporting configuration to be fulfilled by the UEs attached to the eNodeB entity.
virtual void DoInitialize()
Initialize() implementation.
Smart pointer class similar to boost::intrusive_ptr.
a unique identifier for an interface.
TypeId SetParent(TypeId tid)
Set the parent TypeId.
Hold an unsigned integer type.
#define NS_ASSERT(condition)
At runtime, in debugging builds, if this condition is not true, the program prints the source file,...
#define NS_ASSERT_MSG(condition, message)
At runtime, in debugging builds, if this condition is not true, the program prints the message to out...
Ptr< const AttributeChecker > MakeUintegerChecker()
Ptr< const AttributeAccessor > MakeUintegerAccessor(T1 a1)
Create an AttributeAccessor for a class data member, or a lone class get functor or set method.
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
#define NS_LOG_LOGIC(msg)
Use NS_LOG to output a message of level LOG_LOGIC.
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by ",...
#define NS_LOG_WARN(msg)
Use NS_LOG to output a message of level LOG_WARN.
#define NS_OBJECT_ENSURE_REGISTERED(type)
Register an Object subclass with the TypeId system.
Ptr< T > Create(Ts &&... args)
Create class instances by constructors with varying numbers of arguments and return them by Ptr.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
uint8_t rsrqResult
the RSRQ result
bool haveMeasResultNeighCells
have measure result neighbor cells
std::list< MeasResultEutra > measResultListEutra
measure result list eutra
MeasResultPCell measResultPCell
measurement result primary cell
Specifies criteria for triggering of an E-UTRA measurement reporting event.
enum ns3::LteRrcSap::ReportConfigEutra::@62 eventId
Event enumeration.
@ RSRQ
Reference Signal Received Quality.
@ EVENT_A2
Event A2: Serving becomes worse than absolute threshold.
@ EVENT_A4
Event A4: Neighbour becomes better than absolute threshold.
enum ns3::LteRrcSap::ReportConfigEutra::@65 reportInterval
Report interval enumeration.
enum ns3::LteRrcSap::ReportConfigEutra::@63 triggerQuantity
Trigger type enumeration.
ThresholdEutra threshold1
Threshold for event A1, A2, A4, and A5.
@ THRESHOLD_RSRQ
RSRQ is used for the threshold.
enum ns3::LteRrcSap::ThresholdEutra::@60 choice
Threshold enumeration.
uint8_t range
Value range used in RSRP/RSRQ threshold.