A Discrete-Event Network Simulator
API
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
ns3::LteFrHardAlgorithm Class Reference

Hard Frequency Reuse algorithm implementation which uses only 1 sub-band. More...

#include <lte-fr-hard-algorithm.h>

+ Inheritance diagram for ns3::LteFrHardAlgorithm:
+ Collaboration diagram for ns3::LteFrHardAlgorithm:

Public Member Functions

 LteFrHardAlgorithm ()
 Creates a trivial ffr algorithm instance. More...
 
virtual ~LteFrHardAlgorithm ()
 
virtual LteFfrRrcSapProviderGetLteFfrRrcSapProvider ()
 Export the "provider" part of the LteFfrRrcSap interface. More...
 
virtual LteFfrSapProviderGetLteFfrSapProvider ()
 Export the "provider" part of the LteFfrSap interface. More...
 
virtual void SetLteFfrRrcSapUser (LteFfrRrcSapUser *s)
 Set the "user" part of the LteFfrRrcSap interface that this frequency reuse algorithm instance will interact with. More...
 
virtual void SetLteFfrSapUser (LteFfrSapUser *s)
 Set the "user" part of the LteFfrSap interface that this frequency reuse algorithm instance will interact with. More...
 
- Public Member Functions inherited from ns3::LteFfrAlgorithm
 LteFfrAlgorithm ()
 
virtual ~LteFfrAlgorithm ()
 
uint8_t GetDlBandwidth () const
 
uint8_t GetFrCellTypeId () const
 
uint8_t GetUlBandwidth () const
 
void SetDlBandwidth (uint8_t bw)
 
void SetFrCellTypeId (uint8_t cellTypeId)
 
void SetUlBandwidth (uint8_t bw)
 
- Public Member Functions inherited from ns3::Object
 Object ()
 
virtual ~Object ()
 
void AggregateObject (Ptr< Object > other)
 
void Dispose (void)
 Run the DoDispose methods of this object and all the objects aggregated to it. More...
 
AggregateIterator GetAggregateIterator (void) const
 
virtual TypeId GetInstanceTypeId (void) const
 
template<typename T >
Ptr< T > GetObject (void) const
 
template<typename T >
Ptr< T > GetObject (TypeId tid) const
 
void Initialize (void)
 This method calls the virtual DoInitialize method on all the objects aggregated to this object. More...
 
- Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter >
 SimpleRefCount ()
 Constructor. More...
 
 SimpleRefCount (const SimpleRefCount &o)
 Copy constructor. More...
 
uint32_t GetReferenceCount (void) const
 Get the reference count of the object. More...
 
SimpleRefCountoperator= (const SimpleRefCount &o)
 Assignment. More...
 
void Ref (void) const
 Increment the reference count. More...
 
void Unref (void) const
 Decrement the reference count. More...
 
- Public Member Functions inherited from ns3::ObjectBase
virtual ~ObjectBase ()
 Virtual destructor. More...
 
void GetAttribute (std::string name, AttributeValue &value) const
 
bool GetAttributeFailSafe (std::string name, AttributeValue &attribute) const
 
void SetAttribute (std::string name, const AttributeValue &value)
 
bool SetAttributeFailSafe (std::string name, const AttributeValue &value)
 
bool TraceConnect (std::string name, std::string context, const CallbackBase &cb)
 
bool TraceConnectWithoutContext (std::string name, const CallbackBase &cb)
 
bool TraceDisconnect (std::string name, std::string context, const CallbackBase &cb)
 
bool TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb)
 

Static Public Member Functions

static TypeId GetTypeId ()
 
- Static Public Member Functions inherited from ns3::LteFfrAlgorithm
static TypeId GetTypeId ()
 
- Static Public Member Functions inherited from ns3::Object
static TypeId GetTypeId (void)
 Register this type. More...
 
- Static Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter >
static void Cleanup (void)
 Noop. More...
 
- Static Public Member Functions inherited from ns3::ObjectBase
static TypeId GetTypeId (void)
 Get the type ID. More...
 

Protected Member Functions

virtual void DoDispose ()
 This method is called by Object::Dispose or by the object's destructor, whichever comes first. More...
 
virtual std::vector< bool > DoGetAvailableDlRbg ()
 Implementation of LteFfrSapProvider::GetAvailableDlRbg. More...
 
virtual std::vector< bool > DoGetAvailableUlRbg ()
 Implementation of LteFfrSapProvider::GetAvailableUlRbg. More...
 
virtual uint8_t DoGetMinContinuousUlBandwidth ()
 DoGetMinContinuousUlBandwidth in number of RB. More...
 
virtual uint8_t DoGetTpc (uint16_t rnti)
 DoGetTpc for UE. More...
 
virtual void DoInitialize ()
 This method is called only once by Object::Initialize. More...
 
virtual bool DoIsDlRbgAvailableForUe (int i, uint16_t rnti)
 Implementation of LteFfrSapProvider::IsDlRbgAvailableForUe. More...
 
virtual bool DoIsUlRbgAvailableForUe (int i, uint16_t rnti)
 Implementation of LteFfrSapProvider::IsUlRbgAvailableForUe. More...
 
virtual void DoRecvLoadInformation (EpcX2Sap::LoadInformationParams params)
 DoRecvLoadInformation. More...
 
virtual void DoReportDlCqiInfo (const struct FfMacSchedSapProvider::SchedDlCqiInfoReqParameters &params)
 DoReportDlCqiInfo. More...
 
virtual void DoReportUeMeas (uint16_t rnti, LteRrcSap::MeasResults measResults)
 Implementation of LteFfrRrcSapProvider::ReportUeMeas. More...
 
virtual void DoReportUlCqiInfo (const struct FfMacSchedSapProvider::SchedUlCqiInfoReqParameters &params)
 DoReportUlCqiInfo. More...
 
virtual void DoReportUlCqiInfo (std::map< uint16_t, std::vector< double > > ulCqiMap)
 DoReportUlCqiInfo. More...
 
virtual void Reconfigure ()
 Automatic FR reconfiguration. More...
 
- Protected Member Functions inherited from ns3::LteFfrAlgorithm
virtual void DoSetBandwidth (uint8_t ulBandwidth, uint8_t dlBandwidth)
 Implementation of LteFfrRrcSapProvider::SetBandwidth. More...
 
virtual void DoSetCellId (uint16_t cellId)
 SetCellId. More...
 
int GetRbgSize (int dlbandwidth)
 Get RBG size for DL Bandwidth according to table 7.1.6.1-1 of 36.213. More...
 
- Protected Member Functions inherited from ns3::Object
 Object (const Object &o)
 
virtual void NotifyNewAggregate (void)
 This method is invoked whenever two sets of objects are aggregated together. More...
 
- Protected Member Functions inherited from ns3::ObjectBase
void ConstructSelf (const AttributeConstructionList &attributes)
 
virtual void NotifyConstructionCompleted (void)
 This method is invoked once all member attributes have been initialized. More...
 

Private Member Functions

void InitializeDownlinkRbgMaps ()
 
void InitializeUplinkRbgMaps ()
 
void SetDownlinkConfiguration (uint16_t cellId, uint8_t bandwidth)
 
void SetUplinkConfiguration (uint16_t cellId, uint8_t bandwidth)
 

Private Attributes

uint8_t m_dlOffset
 
std::vector< bool > m_dlRbgMap
 
uint8_t m_dlSubBand
 
LteFfrRrcSapProviderm_ffrRrcSapProvider
 
LteFfrRrcSapUserm_ffrRrcSapUser
 
LteFfrSapProviderm_ffrSapProvider
 
LteFfrSapUserm_ffrSapUser
 
uint8_t m_ulOffset
 
std::vector< bool > m_ulRbgMap
 
uint8_t m_ulSubBand
 

Friends

class MemberLteFfrRrcSapProvider< LteFrHardAlgorithm >
 
class MemberLteFfrSapProvider< LteFrHardAlgorithm >
 

Additional Inherited Members

- Protected Attributes inherited from ns3::LteFfrAlgorithm
uint16_t m_cellId
 
uint8_t m_dlBandwidth
 downlink bandwidth in RBs More...
 
bool m_enabledInUplink
 If true FR algorithm will also work in Uplink. More...
 
uint8_t m_frCellTypeId
 FFR cell type ID for automatic configuration. More...
 
bool m_needReconfiguration
 If true FR algorithm will be reconfigured. More...
 
uint8_t m_ulBandwidth
 uplink bandwidth in RBs More...
 

Detailed Description

Hard Frequency Reuse algorithm implementation which uses only 1 sub-band.

Config Paths

ns3::LteFrHardAlgorithm is accessible through the following paths with Config::Set and Config::Connect:

  • /NodeList/[i]/DeviceList/[i]/$ns3::LteEnbNetDevice/LteFfrAlgorithm/$ns3::LteFrHardAlgorithm
  • /NodeList/[i]/DeviceList/[i]/$ns3::LteNetDevice/$ns3::LteEnbNetDevice/LteFfrAlgorithm/$ns3::LteFrHardAlgorithm

Attributes

  • UlSubBandOffset: Uplink Offset in number of Resource Block Groups
  • UlSubBandwidth: Uplink Transmission SubBandwidth Configuration in number of Resource Block Groups
  • DlSubBandOffset: Downlink Offset in number of Resource Block Groups
  • DlSubBandwidth: Downlink Transmission SubBandwidth Configuration in number of Resource Block Groups

Attributes defined in parent class ns3::LteFfrAlgorithm

  • FrCellTypeId: Downlink FR cell type ID for automatic configuration,default value is 0 and it means that user needs to configure FR algorithm manually,if it is set to 1,2 or 3 FR algorithm will be configured automatically
  • EnabledInUplink: If FR algorithm will also work in Uplink, default value true
    • Set with class: BooleanValue
    • Underlying type: bool
    • Initial value: true
    • Flags: construct write read

No TraceSources are defined for this type.

Definition at line 36 of file lte-fr-hard-algorithm.h.

Constructor & Destructor Documentation

ns3::LteFrHardAlgorithm::LteFrHardAlgorithm ( )

Creates a trivial ffr algorithm instance.

Definition at line 82 of file lte-fr-hard-algorithm.cc.

References m_ffrRrcSapProvider, m_ffrSapProvider, and NS_LOG_FUNCTION.

ns3::LteFrHardAlgorithm::~LteFrHardAlgorithm ( )
virtual

Definition at line 96 of file lte-fr-hard-algorithm.cc.

References NS_LOG_FUNCTION.

Member Function Documentation

void ns3::LteFrHardAlgorithm::DoDispose ( void  )
protectedvirtual

This method is called by Object::Dispose or by the object's destructor, whichever comes first.

Subclasses are expected to implement their real destruction code in an overriden version of this method and chain up to their parent's implementation once they are done. i.e., for simplicity, the destructor of every subclass should be empty and its content should be moved to the associated DoDispose method.

It is safe to call GetObject from within this method.

Reimplemented from ns3::LteFfrAlgorithm.

Definition at line 103 of file lte-fr-hard-algorithm.cc.

References m_ffrRrcSapProvider, m_ffrSapProvider, and NS_LOG_FUNCTION.

std::vector< bool > ns3::LteFrHardAlgorithm::DoGetAvailableDlRbg ( )
protectedvirtual

Implementation of LteFfrSapProvider::GetAvailableDlRbg.

Returns
vector of size (m_dlBandwidth/RbgSize); false indicates that RBG is free to use, true otherwise

Implements ns3::LteFfrAlgorithm.

Definition at line 279 of file lte-fr-hard-algorithm.cc.

References InitializeDownlinkRbgMaps(), m_dlRbgMap, ns3::LteFfrAlgorithm::m_needReconfiguration, NS_LOG_FUNCTION, and Reconfigure().

+ Here is the call graph for this function:

std::vector< bool > ns3::LteFrHardAlgorithm::DoGetAvailableUlRbg ( )
protectedvirtual

Implementation of LteFfrSapProvider::GetAvailableUlRbg.

Returns
vector of size m_ulBandwidth; false indicates that RB is free to use, true otherwise

Implements ns3::LteFfrAlgorithm.

Definition at line 304 of file lte-fr-hard-algorithm.cc.

References InitializeUplinkRbgMaps(), m_ulRbgMap, and NS_LOG_FUNCTION.

+ Here is the call graph for this function:

uint8_t ns3::LteFrHardAlgorithm::DoGetMinContinuousUlBandwidth ( )
protectedvirtual

DoGetMinContinuousUlBandwidth in number of RB.

Returns
number of RB in min continous UL Bandwidth

Implements ns3::LteFfrAlgorithm.

Definition at line 358 of file lte-fr-hard-algorithm.cc.

References ns3::LteFfrAlgorithm::m_enabledInUplink, ns3::LteFfrAlgorithm::m_ulBandwidth, m_ulSubBand, and NS_LOG_FUNCTION.

uint8_t ns3::LteFrHardAlgorithm::DoGetTpc ( uint16_t  rnti)
protectedvirtual

DoGetTpc for UE.

Parameters
rnti
Returns
TPC value

Implements ns3::LteFfrAlgorithm.

Definition at line 351 of file lte-fr-hard-algorithm.cc.

References NS_LOG_FUNCTION.

void ns3::LteFrHardAlgorithm::DoInitialize ( void  )
protectedvirtual

This method is called only once by Object::Initialize.

If the user calls Object::Initialize multiple times, DoInitialize is called only the first time.

Subclasses are expected to override this method and chain up to their parent's implementation once they are done. It is safe to call GetObject and AggregateObject from within this method.

Reimplemented from ns3::Object.

Definition at line 174 of file lte-fr-hard-algorithm.cc.

References ns3::Object::DoInitialize(), ns3::LteFfrAlgorithm::m_dlBandwidth, ns3::LteFfrAlgorithm::m_frCellTypeId, ns3::LteFfrAlgorithm::m_ulBandwidth, NS_ASSERT_MSG, NS_LOG_FUNCTION, SetDownlinkConfiguration(), and SetUplinkConfiguration().

+ Here is the call graph for this function:

bool ns3::LteFrHardAlgorithm::DoIsDlRbgAvailableForUe ( int  rbId,
uint16_t  rnti 
)
protectedvirtual

Implementation of LteFfrSapProvider::IsDlRbgAvailableForUe.

Parameters
rbId
rntiRadio Network Temporary Identity, an integer identifying the UE where the report originates from
Returns
true if UE can be served on i-th RB, false otherwise

Implements ns3::LteFfrAlgorithm.

Definition at line 297 of file lte-fr-hard-algorithm.cc.

References m_dlRbgMap, and NS_LOG_FUNCTION.

bool ns3::LteFrHardAlgorithm::DoIsUlRbgAvailableForUe ( int  rbId,
uint16_t  rnti 
)
protectedvirtual

Implementation of LteFfrSapProvider::IsUlRbgAvailableForUe.

Parameters
rbId
rntiRadio Network Temporary Identity, an integer identifying the UE where the report originates from
Returns
true if UE can be served on i-th RB, false otherwise

Implements ns3::LteFfrAlgorithm.

Definition at line 317 of file lte-fr-hard-algorithm.cc.

References ns3::LteFfrAlgorithm::m_enabledInUplink, m_ulRbgMap, and NS_LOG_FUNCTION.

void ns3::LteFrHardAlgorithm::DoRecvLoadInformation ( EpcX2Sap::LoadInformationParams  params)
protectedvirtual

DoRecvLoadInformation.

Parameters
params

Implements ns3::LteFfrAlgorithm.

Definition at line 379 of file lte-fr-hard-algorithm.cc.

References NS_LOG_FUNCTION, and NS_LOG_WARN.

void ns3::LteFrHardAlgorithm::DoReportDlCqiInfo ( const struct FfMacSchedSapProvider::SchedDlCqiInfoReqParameters params)
protectedvirtual

DoReportDlCqiInfo.

Parameters
params

Implements ns3::LteFfrAlgorithm.

Definition at line 330 of file lte-fr-hard-algorithm.cc.

References NS_LOG_FUNCTION, and NS_LOG_WARN.

void ns3::LteFrHardAlgorithm::DoReportUeMeas ( uint16_t  rnti,
LteRrcSap::MeasResults  measResults 
)
protectedvirtual

Implementation of LteFfrRrcSapProvider::ReportUeMeas.

Parameters
rntiRadio Network Temporary Identity, an integer identifying the UE where the report originates from
measResultsa single report of one measurement identity

Implements ns3::LteFfrAlgorithm.

Definition at line 371 of file lte-fr-hard-algorithm.cc.

References ns3::LteRrcSap::MeasResults::measId, NS_LOG_FUNCTION, and NS_LOG_WARN.

void ns3::LteFrHardAlgorithm::DoReportUlCqiInfo ( const struct FfMacSchedSapProvider::SchedUlCqiInfoReqParameters params)
protectedvirtual

DoReportUlCqiInfo.

Parameters
params

Implements ns3::LteFfrAlgorithm.

Definition at line 337 of file lte-fr-hard-algorithm.cc.

References NS_LOG_FUNCTION, and NS_LOG_WARN.

void ns3::LteFrHardAlgorithm::DoReportUlCqiInfo ( std::map< uint16_t, std::vector< double > >  ulCqiMap)
protectedvirtual

DoReportUlCqiInfo.

Parameters
ulCqiMap

Implements ns3::LteFfrAlgorithm.

Definition at line 344 of file lte-fr-hard-algorithm.cc.

References NS_LOG_FUNCTION, and NS_LOG_WARN.

LteFfrRrcSapProvider * ns3::LteFrHardAlgorithm::GetLteFfrRrcSapProvider ( )
virtual

Export the "provider" part of the LteFfrRrcSap interface.

Returns
the reference to the "provider" part of the interface, typically to be kept by an LteEnbRrc instance

Implements ns3::LteFfrAlgorithm.

Definition at line 166 of file lte-fr-hard-algorithm.cc.

References m_ffrRrcSapProvider, and NS_LOG_FUNCTION.

LteFfrSapProvider * ns3::LteFrHardAlgorithm::GetLteFfrSapProvider ( )
virtual

Export the "provider" part of the LteFfrSap interface.

Returns
the reference to the "provider" part of the interface, typically to be kept by an Scheduler instance

Implements ns3::LteFfrAlgorithm.

Definition at line 151 of file lte-fr-hard-algorithm.cc.

References m_ffrSapProvider, and NS_LOG_FUNCTION.

TypeId ns3::LteFrHardAlgorithm::GetTypeId ( void  )
static

Definition at line 112 of file lte-fr-hard-algorithm.cc.

References m_dlOffset, m_dlSubBand, m_ulOffset, m_ulSubBand, and ns3::TypeId::SetParent().

+ Here is the call graph for this function:

void ns3::LteFrHardAlgorithm::InitializeDownlinkRbgMaps ( )
private

Definition at line 235 of file lte-fr-hard-algorithm.cc.

References ns3::LteFfrAlgorithm::GetRbgSize(), ns3::LteFfrAlgorithm::m_dlBandwidth, m_dlOffset, m_dlRbgMap, m_dlSubBand, and NS_ASSERT_MSG.

Referenced by DoGetAvailableDlRbg(), and Reconfigure().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void ns3::LteFrHardAlgorithm::InitializeUplinkRbgMaps ( )
private

Definition at line 255 of file lte-fr-hard-algorithm.cc.

References ns3::LteFfrAlgorithm::m_enabledInUplink, ns3::LteFfrAlgorithm::m_ulBandwidth, m_ulOffset, m_ulRbgMap, m_ulSubBand, and NS_ASSERT_MSG.

Referenced by DoGetAvailableUlRbg(), and Reconfigure().

+ Here is the caller graph for this function:

void ns3::LteFrHardAlgorithm::Reconfigure ( )
protectedvirtual
void ns3::LteFrHardAlgorithm::SetDownlinkConfiguration ( uint16_t  cellId,
uint8_t  bandwidth 
)
private
void ns3::LteFrHardAlgorithm::SetLteFfrRrcSapUser ( LteFfrRrcSapUser s)
virtual

Set the "user" part of the LteFfrRrcSap interface that this frequency reuse algorithm instance will interact with.

Parameters
sa reference to the "user" part of the interface, typically a member of an LteEnbRrc instance

Implements ns3::LteFfrAlgorithm.

Definition at line 158 of file lte-fr-hard-algorithm.cc.

References m_ffrRrcSapUser, NS_LOG_FUNCTION, and s.

void ns3::LteFrHardAlgorithm::SetLteFfrSapUser ( LteFfrSapUser s)
virtual

Set the "user" part of the LteFfrSap interface that this frequency reuse algorithm instance will interact with.

Parameters
sa reference to the "user" part of the interface, typically a member of an Scheduler instance

Implements ns3::LteFfrAlgorithm.

Definition at line 143 of file lte-fr-hard-algorithm.cc.

References m_ffrSapUser, NS_LOG_FUNCTION, and s.

void ns3::LteFrHardAlgorithm::SetUplinkConfiguration ( uint16_t  cellId,
uint8_t  bandwidth 
)
private

Friends And Related Function Documentation

Definition at line 58 of file lte-fr-hard-algorithm.h.

Definition at line 57 of file lte-fr-hard-algorithm.h.

Member Data Documentation

uint8_t ns3::LteFrHardAlgorithm::m_dlOffset
private
std::vector<bool> ns3::LteFrHardAlgorithm::m_dlRbgMap
private
uint8_t ns3::LteFrHardAlgorithm::m_dlSubBand
private
LteFfrRrcSapProvider* ns3::LteFrHardAlgorithm::m_ffrRrcSapProvider
private

Definition at line 94 of file lte-fr-hard-algorithm.h.

Referenced by DoDispose(), GetLteFfrRrcSapProvider(), and LteFrHardAlgorithm().

LteFfrRrcSapUser* ns3::LteFrHardAlgorithm::m_ffrRrcSapUser
private

Definition at line 93 of file lte-fr-hard-algorithm.h.

Referenced by SetLteFfrRrcSapUser().

LteFfrSapProvider* ns3::LteFrHardAlgorithm::m_ffrSapProvider
private

Definition at line 90 of file lte-fr-hard-algorithm.h.

Referenced by DoDispose(), GetLteFfrSapProvider(), and LteFrHardAlgorithm().

LteFfrSapUser* ns3::LteFrHardAlgorithm::m_ffrSapUser
private

Definition at line 89 of file lte-fr-hard-algorithm.h.

Referenced by SetLteFfrSapUser().

uint8_t ns3::LteFrHardAlgorithm::m_ulOffset
private
std::vector<bool> ns3::LteFrHardAlgorithm::m_ulRbgMap
private
uint8_t ns3::LteFrHardAlgorithm::m_ulSubBand
private

The documentation for this class was generated from the following files: