30 #include <ns3/uinteger.h>
46 : m_servingCellThreshold (30),
47 m_neighbourCellOffset (1),
48 m_handoverManagementSapUser (0)
64 static TypeId tid =
TypeId (
"ns3::A2A4RsrqHandoverAlgorithm")
68 .AddAttribute (
"ServingCellThreshold",
69 "If the RSRQ of the serving cell is worse than this "
70 "threshold, neighbour cells are consider for handover. "
71 "Expressed in quantized range of [0..34] as per Section "
72 "9.1.7 of 3GPP TS 36.133.",
75 MakeUintegerChecker<uint8_t> (0, 34))
76 .AddAttribute (
"NeighbourCellOffset",
77 "Minimum offset between the serving and the best neighbour "
78 "cell to trigger the handover. Expressed in quantized "
79 "range of [0..34] as per Section 9.1.7 of 3GPP TS 36.133.",
82 MakeUintegerChecker<uint8_t> ())
109 NS_LOG_LOGIC (
this <<
" requesting Event A2 measurements"
119 NS_LOG_LOGIC (
this <<
" requesting Event A4 measurements"
120 <<
" (threshold=0)");
150 "Invalid UE measurement report");
158 for (std::list <LteRrcSap::MeasResultEutra>::iterator it = measResults.
measResultListEutra.begin ();
163 "RSRQ measurement is missing from cellId " << it->physCellId);
169 NS_LOG_WARN (
this <<
" Event A4 received without measurement results from neighbouring cells");
182 uint8_t servingCellRsrq)
186 MeasurementTable_t::iterator it1;
191 NS_LOG_WARN (
"Skipping handover evaluation for RNTI " << rnti <<
" because neighbour cells information is not found");
196 NS_LOG_LOGIC (
"Number of neighbour cells = " << it1->second.size ());
197 uint16_t bestNeighbourCellId = 0;
198 uint8_t bestNeighbourRsrq = 0;
199 MeasurementRow_t::iterator it2;
200 for (it2 = it1->second.begin (); it2 != it1->second.end (); ++it2)
202 if ((it2->second->m_rsrq > bestNeighbourRsrq)
205 bestNeighbourCellId = it2->first;
206 bestNeighbourRsrq = it2->second->m_rsrq;
211 if (bestNeighbourCellId > 0)
213 NS_LOG_LOGIC (
"Best neighbour cellId " << bestNeighbourCellId);
217 NS_LOG_LOGIC (
"Trigger Handover to cellId " << bestNeighbourCellId);
218 NS_LOG_LOGIC (
"target cell RSRQ " << (uint16_t) bestNeighbourRsrq);
219 NS_LOG_LOGIC (
"serving cell RSRQ " << (uint16_t) servingCellRsrq);
223 bestNeighbourCellId);
253 MeasurementTable_t::iterator it1;
260 std::pair<MeasurementTable_t::iterator, bool> ret;
268 std::map<uint16_t, Ptr<UeMeasure> >::iterator it2;
269 it2 = it1->second.find (cellId);
271 if (it2 != it1->second.end ())
273 neighbourCellMeasures = it2->second;
274 neighbourCellMeasures->m_cellId = cellId;
275 neighbourCellMeasures->m_rsrp = 0;
276 neighbourCellMeasures->m_rsrq = rsrq;
281 neighbourCellMeasures = Create<UeMeasure> ();
282 neighbourCellMeasures->m_cellId = cellId;
283 neighbourCellMeasures->m_rsrp = 0;
284 neighbourCellMeasures->m_rsrq = rsrq;
285 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.
virtual void DoDispose()
Destructor implementation.
virtual void DoInitialize()
Initialize() implementation.
void DoReportUeMeas(uint16_t rnti, LteRrcSap::MeasResults measResults)
Implementation of LteHandoverManagementSapProvider::ReportUeMeas.
A2A4RsrqHandoverAlgorithm()
Creates an A2-A4-RSRQ handover algorithm instance.
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 EvaluateHandover(uint16_t rnti, uint8_t servingCellRsrq)
Called when Event A2 is detected, then trigger a handover if needed.
virtual void SetLteHandoverManagementSapUser(LteHandoverManagementSapUser *s)
Set the "user" part of the Handover Management SAP interface that this handover algorithm instance wi...
MeasurementTable_t m_neighbourCellMeasures
Table of measurement reports from all UEs.
virtual ~A2A4RsrqHandoverAlgorithm()
uint8_t m_servingCellThreshold
The ServingCellThreshold attribute.
virtual LteHandoverManagementSapProvider * GetLteHandoverManagementSapProvider()
Export the "provider" part of the Handover Management SAP interface.
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 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 TriggerHandover(uint16_t rnti, uint16_t targetCellId)=0
Instruct the eNodeB RRC entity to prepare a handover.
virtual void DoInitialize(void)
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 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.
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.
@ EVENT_A2
Event A2: Serving becomes worse than absolute threshold.
@ EVENT_A4
Event A4: Neighbour becomes better than absolute threshold.
@ RSRQ
Reference Signal Received Quality.
ThresholdEutra threshold1
Threshold for event A1, A2, A4, and A5.
enum ns3::LteRrcSap::ReportConfigEutra::@67 triggerQuantity
Trigger type enumeration.
enum ns3::LteRrcSap::ReportConfigEutra::@66 eventId
Event enumeration.
enum ns3::LteRrcSap::ReportConfigEutra::@69 reportInterval
Report interval enumeration.
@ THRESHOLD_RSRQ
RSRQ is used for the threshold.
uint8_t range
Value range used in RSRP/RSRQ threshold.
enum ns3::LteRrcSap::ThresholdEutra::@64 choice
Threshold enumeration.