A Discrete-Event Network Simulator
API
lte-ffr-simple.h
Go to the documentation of this file.
1 /* -*- Mode: C++; c-file-style: "gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2014 Piotr Gawlowicz
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  * Author: Piotr Gawlowicz <gawlowicz.p@gmail.com>
19  *
20  */
21 
22 #ifndef LTE_FFR_SIMPLE_H
23 #define LTE_FFR_SIMPLE_H
24 
25 #include <ns3/lte-ffr-algorithm.h>
26 #include <ns3/lte-ffr-sap.h>
27 #include <ns3/lte-ffr-rrc-sap.h>
28 #include <ns3/lte-rrc-sap.h>
29 
30 #include <ns3/traced-callback.h>
31 #include <map>
32 
33 namespace ns3 {
34 
35 
43 {
44 public:
48  LteFfrSimple ();
49 
50  virtual ~LteFfrSimple ();
51 
52  // inherited from Object
53  static TypeId GetTypeId ();
54 
55  void ChangePdschConfigDedicated (bool change);
56  void SetPdschConfigDedicated (LteRrcSap::PdschConfigDedicated pdschConfigDedicated);
57 
58  void SetTpc (uint32_t tpc, uint32_t num, bool acculumatedMode);
59 
60  // inherited from LteFfrAlgorithm
61  virtual void SetLteFfrSapUser (LteFfrSapUser* s);
63 
64  virtual void SetLteFfrRrcSapUser (LteFfrRrcSapUser* s);
66 
67  // let the forwarder class access the protected and private members
70 
77  typedef void (* PdschTracedCallback)(uint16_t rnti, uint8_t pdschPa);
78 
79 protected:
80  // inherited from Object
81  virtual void DoInitialize ();
82  virtual void DoDispose ();
83 
84  virtual void Reconfigure ();
85 
86  // FFR SAP PROVIDER IMPLEMENTATION
87  virtual std::vector <bool> DoGetAvailableDlRbg ();
88  virtual bool DoIsDlRbgAvailableForUe (int i, uint16_t rnti);
89  virtual std::vector <bool> DoGetAvailableUlRbg ();
90  virtual bool DoIsUlRbgAvailableForUe (int i, uint16_t rnti);
93  virtual void DoReportUlCqiInfo ( std::map <uint16_t, std::vector <double> > ulCqiMap );
94  virtual uint8_t DoGetTpc (uint16_t rnti);
95  virtual uint8_t DoGetMinContinuousUlBandwidth ();
96 
97  // FFR SAP RRC PROVIDER IMPLEMENTATION
98  virtual void DoReportUeMeas (uint16_t rnti, LteRrcSap::MeasResults measResults);
100 
101 private:
102 
104 
105  // FFR SAP
108 
109  // FFR RRF SAP
112 
113  uint8_t m_dlOffset;
114  uint8_t m_dlSubBand;
115 
116  uint8_t m_ulOffset;
117  uint8_t m_ulSubBand;
118 
119  std::vector <bool> m_dlRbgMap;
120  std::vector <bool> m_ulRbgMap;
121 
122  std::map <uint16_t, LteRrcSap::PdschConfigDedicated> m_ues;
123 
124  // The expected measurement identity
125  uint8_t m_measId;
126 
128 
130 
132 
133 
134  //Uplink Power Control
135  uint32_t m_tpc;
136  uint32_t m_tpcNum;
138 
139 }; // end of class LteFfrSimple
140 
141 
142 } // end of namespace ns3
143 
144 
145 #endif /* LTE_FFR_SIMPLE_H */
Service Access Point (SAP) offered by the Frequency Reuse algorithm instance to the eNodeB RRC instan...
Template for the implementation of the LteFfrRrcSapProvider as a member of an owner class of type C t...
Service Access Point (SAP) offered by the eNodeB RRC instance to the Frequency Reuse algorithm instan...
Definition: lte-ffr-sap.h:132
virtual void DoReportUeMeas(uint16_t rnti, LteRrcSap::MeasResults measResults)
Implementation of LteFfrRrcSapProvider::ReportUeMeas.
virtual void DoReportUlCqiInfo(const struct FfMacSchedSapProvider::SchedUlCqiInfoReqParameters &params)
DoReportUlCqiInfo.
LteFfrSapProvider * m_ffrSapProvider
void SetTpc(uint32_t tpc, uint32_t num, bool acculumatedMode)
std::map< uint16_t, LteRrcSap::PdschConfigDedicated > m_ues
virtual std::vector< bool > DoGetAvailableDlRbg()
Implementation of LteFfrSapProvider::GetAvailableDlRbg.
virtual LteFfrSapProvider * GetLteFfrSapProvider()
Export the "provider" part of the LteFfrSap interface.
virtual std::vector< bool > DoGetAvailableUlRbg()
Implementation of LteFfrSapProvider::GetAvailableUlRbg.
std::vector< bool > m_dlRbgMap
LteRrcSap::PdschConfigDedicated m_pdschConfigDedicated
LteFfrRrcSapUser * m_ffrRrcSapUser
Template for the implementation of the LteFfrSapProvider as a member of an owner class of type C to w...
Definition: lte-ffr-sap.h:146
void(* PdschTracedCallback)(uint16_t rnti, uint8_t pdschPa)
TracedCallback signature for change of PdschConfigDedicated.
virtual bool DoIsDlRbgAvailableForUe(int i, uint16_t rnti)
Implementation of LteFfrSapProvider::IsDlRbgAvailableForUe.
static TypeId GetTypeId()
void ChangePdschConfigDedicated(bool change)
Service Access Point (SAP) offered by the Frequency Reuse algorithm instance to the MAC Scheduler ins...
Definition: lte-ffr-sap.h:39
virtual void SetLteFfrRrcSapUser(LteFfrRrcSapUser *s)
Set the "user" part of the LteFfrRrcSap interface that this frequency reuse algorithm instance will i...
virtual bool DoIsUlRbgAvailableForUe(int i, uint16_t rnti)
Implementation of LteFfrSapProvider::IsUlRbgAvailableForUe.
virtual void DoDispose()
Destructor implementation.
Simple Frequency Reuse algorithm implementation which uses only 1 sub-band.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
virtual void Reconfigure()
Automatic FR reconfiguration.
The abstract base class of a Frequency Reuse algorithm.
std::vector< bool > m_ulRbgMap
virtual uint8_t DoGetMinContinuousUlBandwidth()
DoGetMinContinuousUlBandwidth in number of RB.
virtual uint8_t DoGetTpc(uint16_t rnti)
DoGetTpc for UE.
LteFfrSapUser * m_ffrSapUser
Service Access Point (SAP) offered by the eNodeB RRC instance to the Frequency Reuse algorithm instan...
Parameters of the SCHED_DL_CQI_INFO_REQ primitive.
Parameters of the SCHED_UL_CQI_INFO_REQ primitive.
LteFfrSimple()
Creates a trivial ffr algorithm instance.
virtual void SetLteFfrSapUser(LteFfrSapUser *s)
Set the "user" part of the LteFfrSap interface that this frequency reuse algorithm instance will inte...
virtual LteFfrRrcSapProvider * GetLteFfrRrcSapProvider()
Export the "provider" part of the LteFfrRrcSap interface.
virtual void DoReportDlCqiInfo(const struct FfMacSchedSapProvider::SchedDlCqiInfoReqParameters &params)
DoReportDlCqiInfo.
Parameters of the LOAD INFORMATION message.
Definition: epc-x2-sap.h:300
void SetPdschConfigDedicated(LteRrcSap::PdschConfigDedicated pdschConfigDedicated)
LteFfrRrcSapProvider * m_ffrRrcSapProvider
TracedCallback< uint16_t, uint8_t > m_changePdschConfigDedicatedTrace
void UpdatePdschConfigDedicated()
virtual void DoRecvLoadInformation(EpcX2Sap::LoadInformationParams params)
DoRecvLoadInformation.
a unique identifier for an interface.
Definition: type-id.h:58
virtual void DoInitialize()
Initialize() implementation.
bool m_changePdschConfigDedicated
virtual ~LteFfrSimple()