A Discrete-Event Network Simulator
API
Loading...
Searching...
No Matches
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
32#include "lte-rrc-sap.h"
33
34#include <ns3/ptr.h>
35#include <ns3/simple-ref-count.h>
36
37#include <map>
38
39namespace ns3
40{
41
82{
83 public:
86
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