A Discrete-Event Network Simulator
API
a2-a4-rsrq-handover-algorithm.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2011, 2012 Centre Tecnologic de Telecomunicacions de Catalunya (CTTC)
3  * Copyright (c) 2013 Budiarto Herman
4  *
5  * This program is free software; you can redistribute it and/or modify
6  * it under the terms of the GNU General Public License version 2 as
7  * published by the Free Software Foundation;
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software
16  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17  *
18  * Original work authors (from lte-enb-rrc.cc):
19  * Nicola Baldo <nbaldo@cttc.es>
20  * Marco Miozzo <mmiozzo@cttc.es>
21  * Manuel Requena <manuel.requena@cttc.es>
22  *
23  * Converted to handover algorithm interface by:
24  * Budiarto Herman <budiarto.herman@magister.fi>
25  */
26 
27 #ifndef A2_A4_RSRQ_HANDOVER_ALGORITHM_H
28 #define A2_A4_RSRQ_HANDOVER_ALGORITHM_H
29 
30 #include "lte-handover-algorithm.h"
32 #include "lte-rrc-sap.h"
33 
34 #include <ns3/ptr.h>
35 #include <ns3/simple-ref-count.h>
36 
37 #include <map>
38 
39 namespace ns3
40 {
41 
82 {
83  public:
86 
87  ~A2A4RsrqHandoverAlgorithm() override;
88 
93  static TypeId GetTypeId();
94 
95  // inherited from LteHandoverAlgorithm
98 
101 
102  protected:
103  // inherited from Object
104  void DoInitialize() override;
105  void DoDispose() override;
106 
107  // inherited from LteHandoverAlgorithm as a Handover Management SAP implementation
108  void DoReportUeMeas(uint16_t rnti, LteRrcSap::MeasResults measResults) override;
109 
110  private:
117  void EvaluateHandover(uint16_t rnti, uint8_t servingCellRsrq);
118 
126  bool IsValidNeighbour(uint16_t cellId);
127 
138  void UpdateNeighbourMeasurements(uint16_t rnti, uint16_t cellId, uint8_t rsrq);
139 
141  std::vector<uint8_t> m_a2MeasIds;
143  std::vector<uint8_t> m_a4MeasIds;
144 
149  class UeMeasure : public SimpleRefCount<UeMeasure>
150  {
151  public:
152  uint16_t m_cellId;
153  uint8_t m_rsrp;
154  uint8_t m_rsrq;
155  };
156 
161  typedef std::map<uint16_t, Ptr<UeMeasure>> MeasurementRow_t;
162 
167  typedef std::map<uint16_t, MeasurementRow_t> MeasurementTable_t;
168 
171 
179 
186 
191 
192 }; // end of class A2A4RsrqHandoverAlgorithm
193 
194 } // end of namespace ns3
195 
196 #endif /* A2_A4_RSRQ_HANDOVER_ALGORITHM_H */
Measurements reported by a UE for a cell ID.
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.
std::map< uint16_t, MeasurementRow_t > MeasurementTable_t
Measurements reported by several UEs.
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.
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.
Template for the implementation of the LteHandoverManagementSapProvider as a member of an owner class...
A template-based reference counting class.
a unique identifier for an interface.
Definition: type-id.h:59
Every class exported by the ns3 library is enclosed in the ns3 namespace.
MeasResults structure.
Definition: lte-rrc-sap.h:717