24 #include "ns3/boolean.h"
54 { 2, 100, 28, 24, 24},
80 { 2, 100, 28, 24, 24},
93 m_dlEdgeSubBandOffset (0),
94 m_dlEdgeSubBandwidth (0),
95 m_ulEdgeSubBandOffset (0),
96 m_ulEdgeSubBandwidth (0),
127 .AddAttribute (
"UlCommonSubBandwidth",
128 "Uplink Medium (Common) SubBandwidth Configuration in number of Resource Block Groups",
131 MakeUintegerChecker<uint8_t> ())
132 .AddAttribute (
"UlEdgeSubBandOffset",
133 "Uplink Edge SubBand Offset in number of Resource Block Groups",
136 MakeUintegerChecker<uint8_t> ())
137 .AddAttribute (
"UlEdgeSubBandwidth",
138 "Uplink Edge SubBandwidth Configuration in number of Resource Block Groups",
141 MakeUintegerChecker<uint8_t> ())
142 .AddAttribute (
"DlCommonSubBandwidth",
143 "Downlink Medium (Common) SubBandwidth Configuration in number of Resource Block Groups",
146 MakeUintegerChecker<uint8_t> ())
147 .AddAttribute (
"DlEdgeSubBandOffset",
148 "Downlink Edge SubBand Offset in number of Resource Block Groups",
151 MakeUintegerChecker<uint8_t> ())
152 .AddAttribute (
"DlEdgeSubBandwidth",
153 "Downlink Edge SubBandwidth Configuration in number of Resource Block Groups",
156 MakeUintegerChecker<uint8_t> ())
157 .AddAttribute (
"CenterRsrqThreshold",
158 "If the RSRQ of is worse than this threshold, UE should be served in Medium sub-band",
161 MakeUintegerChecker<uint8_t> ())
162 .AddAttribute (
"EdgeRsrqThreshold",
163 "If the RSRQ of is worse than this threshold, UE should be served in Edge sub-band",
166 MakeUintegerChecker<uint8_t> ())
167 .AddAttribute (
"CenterAreaPowerOffset",
168 "PdschConfigDedicated::Pa value for Center Sub-band, default value dB0",
171 MakeUintegerChecker<uint8_t> ())
172 .AddAttribute (
"MediumAreaPowerOffset",
173 "PdschConfigDedicated::Pa value for Medium Sub-band, default value dB0",
176 MakeUintegerChecker<uint8_t> ())
177 .AddAttribute (
"EdgeAreaPowerOffset",
178 "PdschConfigDedicated::Pa value for Edge Sub-band, default value dB0",
181 MakeUintegerChecker<uint8_t> ())
182 .AddAttribute (
"CenterAreaTpc",
183 "TPC value which will be set in DL-DCI for UEs in center area"
184 "Absolute mode is used, default value 1 is mapped to -1 according to"
185 "TS36.213 Table 5.1.1.1-2",
188 MakeUintegerChecker<uint8_t> ())
189 .AddAttribute (
"MediumAreaTpc",
190 "TPC value which will be set in DL-DCI for UEs in medium area"
191 "Absolute mode is used, default value 1 is mapped to -1 according to"
192 "TS36.213 Table 5.1.1.1-2",
195 MakeUintegerChecker<uint8_t> ())
196 .AddAttribute (
"EdgeAreaTpc",
197 "TPC value which will be set in DL-DCI for UEs in edge area"
198 "Absolute mode is used, default value 1 is mapped to -1 according to"
199 "TS36.213 Table 5.1.1.1-2",
202 MakeUintegerChecker<uint8_t> ())
254 NS_LOG_LOGIC (
this <<
" requesting Event A1 measurements"
255 <<
" (threshold = 0" <<
")");
327 "DlCommonSubBandwidth + DlEdgeSubBandOffset higher than DlBandwidth");
331 "(DlCommonSubBandwidth + DlEdgeSubBandOffset+DlEdgeSubBandwidth) higher than DlBandwidth");
364 "UlCommonSubBandwidth + UlEdgeSubBandOffset higher than UlBandwidth");
368 "(UlCommonSubBandwidth + UlEdgeSubBandOffset+UlEdgeSubBandwidth) higher than UlBandwidth");
412 std::map< uint16_t, uint8_t >::iterator it =
m_ues.find (rnti);
413 if (it ==
m_ues.end ())
418 it =
m_ues.find (rnti);
427 bool isCenterUe =
false;
428 bool isMediumUe =
false;
429 bool isEdgeUe =
false;
444 return (isCenterRbg && isCenterUe) || (isMediumRbg && isMediumUe) || (isEdgeRbg && isEdgeUe);
474 std::map< uint16_t, uint8_t >::iterator it =
m_ues.find (rnti);
475 if (it ==
m_ues.end ())
480 it =
m_ues.find (rnti);
489 bool isCenterUe =
false;
490 bool isMediumUe =
false;
491 bool isEdgeUe =
false;
506 return (isCenterRbg && isCenterUe) || (isMediumRbg && isMediumUe) || (isEdgeRbg && isEdgeUe);
513 NS_LOG_WARN (
"Method should not be called, because it is empty");
520 NS_LOG_WARN (
"Method should not be called, because it is empty");
527 NS_LOG_WARN (
"Method should not be called, because it is empty");
550 std::map< uint16_t, uint8_t >::iterator it =
m_ues.find (rnti);
551 if (it ==
m_ues.end ())
582 uint8_t centerSubBandwidth = 0;
583 uint8_t mediumSubBandwidth = 0;
584 uint8_t edgeSubBandwidth = 0;
590 centerSubBandwidth++;
598 mediumSubBandwidth++;
612 minContinuousUlBandwidth =
613 ((centerSubBandwidth > 0 ) && (centerSubBandwidth < minContinuousUlBandwidth)) ? centerSubBandwidth : minContinuousUlBandwidth;
615 minContinuousUlBandwidth =
616 ((mediumSubBandwidth > 0 ) && (mediumSubBandwidth < minContinuousUlBandwidth)) ? mediumSubBandwidth : minContinuousUlBandwidth;
618 minContinuousUlBandwidth =
619 ((edgeSubBandwidth > 0 ) && (edgeSubBandwidth < minContinuousUlBandwidth)) ? edgeSubBandwidth : minContinuousUlBandwidth;
621 NS_LOG_INFO (
"minContinuousUlBandwidth: " << (
int)minContinuousUlBandwidth);
623 return minContinuousUlBandwidth;
636 "CenterSubBandThreshold must be higher than EdgeSubBandThreshold");
645 std::map< uint16_t, uint8_t >::iterator it =
m_ues.find (rnti);
646 if (it ==
m_ues.end ())
651 it =
m_ues.find (rnti);
656 NS_LOG_INFO (
"UE RNTI: " << rnti <<
" will be served in Center sub-band");
668 NS_LOG_INFO (
"UE RNTI: " << rnti <<
" will be served in Edge sub-band");
680 NS_LOG_INFO (
"UE RNTI: " << rnti <<
" will be served in Medium sub-band");
695 NS_LOG_WARN (
"Method should not be called, because it is empty");
The abstract base class of a Frequency Reuse algorithm.
bool m_needReconfiguration
If true FR algorithm will be reconfigured.
uint8_t m_frCellTypeId
FFR cell type ID for automatic configuration.
int GetRbgSize(int dlbandwidth)
Get RBG size for DL Bandwidth according to table 7.1.6.1-1 of 36.213.
bool m_enabledInUplink
If true FR algorithm will also work in Uplink.
uint8_t m_dlBandwidth
downlink bandwidth in RBs
uint8_t m_ulBandwidth
uplink bandwidth in RBs
Service Access Point (SAP) offered by the Frequency Reuse algorithm instance to the eNodeB RRC instan...
Service Access Point (SAP) offered by the eNodeB RRC instance to the Frequency Reuse algorithm instan...
virtual void SetPdschConfigDedicated(uint16_t rnti, LteRrcSap::PdschConfigDedicated pdschConfigDedicated)=0
Instruct the eNodeB RRC entity to perform RrcConnectionReconfiguration to inform UE about new PdschCo...
virtual uint8_t AddUeMeasReportConfigForFfr(LteRrcSap::ReportConfigEutra reportConfig)=0
Request a certain reporting configuration to be fulfilled by the UEs attached to the eNodeB entity.
Service Access Point (SAP) offered by the Frequency Reuse algorithm instance to the MAC Scheduler ins...
Service Access Point (SAP) offered by the eNodeB RRC instance to the Frequency Reuse algorithm instan...
Soft Fractional Frequency Reuse algorithm implementation.
virtual void Reconfigure()
Automatic FR reconfiguration.
void SetUplinkConfiguration(uint16_t cellId, uint8_t bandwidth)
Set uplink configuration function.
std::vector< bool > m_dlRbgMap
DL RBG Map.
LteFfrSoftAlgorithm()
Creates a trivial ffr algorithm instance.
uint8_t m_dlEdgeSubBandOffset
DL edge subband offset.
virtual uint8_t DoGetTpc(uint16_t rnti)
DoGetTpc for UE.
LteFfrSapProvider * m_ffrSapProvider
FFR SAP provider.
friend class MemberLteFfrRrcSapProvider< LteFfrSoftAlgorithm >
let the forwarder class access the protected and private members
std::vector< bool > m_ulMediumRbgMap
UL medium RBG map.
uint8_t m_ulEdgeSubBandwidth
UL edge subbandwidth.
uint8_t m_centerAreaTpc
center area tpc
std::vector< bool > m_ulRbgMap
UL RBG map.
virtual bool DoIsDlRbgAvailableForUe(int i, uint16_t rnti)
Implementation of LteFfrSapProvider::IsDlRbgAvailableForUe.
virtual void DoDispose()
Destructor implementation.
virtual bool DoIsUlRbgAvailableForUe(int i, uint16_t rnti)
Implementation of LteFfrSapProvider::IsUlRbgAvailableForUe.
std::vector< bool > m_dlMediumRbgMap
DL medium RBG map.
std::vector< bool > m_dlEdgeRbgMap
DL edge RBG map.
uint8_t m_mediumAreaPowerOffset
medium area power offset
virtual LteFfrRrcSapProvider * GetLteFfrRrcSapProvider()
Export the "provider" part of the LteFfrRrcSap interface.
virtual void DoReportUlCqiInfo(const struct FfMacSchedSapProvider::SchedUlCqiInfoReqParameters ¶ms)
DoReportUlCqiInfo.
uint8_t m_edgeAreaPowerOffset
edge area power offset
virtual ~LteFfrSoftAlgorithm()
virtual void DoReportDlCqiInfo(const struct FfMacSchedSapProvider::SchedDlCqiInfoReqParameters ¶ms)
DoReportDlCqiInfo.
std::vector< bool > m_dlCenterRbgMap
DL center RBG map.
uint8_t m_mediumAreaTpc
medium area tpc
virtual void DoRecvLoadInformation(EpcX2Sap::LoadInformationParams params)
DoRecvLoadInformation.
virtual void SetLteFfrRrcSapUser(LteFfrRrcSapUser *s)
Set the "user" part of the LteFfrRrcSap interface that this frequency reuse algorithm instance will i...
void InitializeUplinkRbgMaps()
Initialize uplink RBG maps function.
uint8_t m_ulEdgeSubBandOffset
UL edge subband offset.
uint8_t m_dlEdgeSubBandwidth
DL edge subbandwidth.
uint8_t m_edgeSubBandThreshold
edge subband threshold
virtual void DoReportUeMeas(uint16_t rnti, LteRrcSap::MeasResults measResults)
Implementation of LteFfrRrcSapProvider::ReportUeMeas.
LteFfrSapUser * m_ffrSapUser
FFR SAP user.
std::vector< bool > m_ulCenterRbgMap
UL center RBG map.
void SetDownlinkConfiguration(uint16_t cellId, uint8_t bandwidth)
Set downlink configuration function.
std::vector< bool > m_ulEdgeRbgMap
UL edge RBG map.
virtual void SetLteFfrSapUser(LteFfrSapUser *s)
Set the "user" part of the LteFfrSap interface that this frequency reuse algorithm instance will inte...
uint8_t m_ulCommonSubBandwidth
UL common subbandwidth.
uint8_t m_centerAreaPowerOffset
center area power offset
virtual std::vector< bool > DoGetAvailableDlRbg()
Implementation of LteFfrSapProvider::GetAvailableDlRbg.
uint8_t m_centerSubBandThreshold
center subband threshold
uint8_t m_measId
The expected measurement identity.
virtual uint16_t DoGetMinContinuousUlBandwidth()
DoGetMinContinuousUlBandwidth in number of RB.
LteFfrRrcSapProvider * m_ffrRrcSapProvider
FFR RRC SAP provider.
LteFfrRrcSapUser * m_ffrRrcSapUser
FFR RRC SAP user.
uint8_t m_dlCommonSubBandwidth
DL common subbandwidth.
void InitializeDownlinkRbgMaps()
Initialize downlink RBG maps function.
std::map< uint16_t, uint8_t > m_ues
UEs.
friend class MemberLteFfrSapProvider< LteFfrSoftAlgorithm >
let the forwarder class access the protected and private members
virtual void DoInitialize()
Initialize() implementation.
virtual std::vector< bool > DoGetAvailableUlRbg()
Implementation of LteFfrSapProvider::GetAvailableUlRbg.
uint8_t m_edgeAreaTpc
edge area tpc
static TypeId GetTypeId()
Get the type ID.
virtual LteFfrSapProvider * GetLteFfrSapProvider()
Export the "provider" part of the LteFfrSap interface.
virtual void DoInitialize(void)
Initialize() implementation.
a unique identifier for an interface.
TypeId SetParent(TypeId tid)
Set the parent TypeId.
Hold an unsigned integer type.
#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_LOG_INFO(msg)
Use NS_LOG to output a message of level LOG_INFO.
#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.
static const struct ns3::FfrSoftUplinkDefaultConfiguration g_ffrSoftUplinkDefaultConfiguration[]
the soft uplink default configuration
const uint16_t NUM_DOWNLINK_CONFS(sizeof(g_ffrEnhancedDownlinkDefaultConfiguration)/sizeof(FfrEnhancedDownlinkDefaultConfiguration))
const uint16_t NUM_UPLINK_CONFS(sizeof(g_ffrEnhancedUplinkDefaultConfiguration)/sizeof(FfrEnhancedUplinkDefaultConfiguration))
static const struct ns3::FfrSoftDownlinkDefaultConfiguration g_ffrSoftDownlinkDefaultConfiguration[]
the soft downlink default configuration
Parameters of the SCHED_DL_CQI_INFO_REQ primitive.
Parameters of the SCHED_UL_CQI_INFO_REQ primitive.
FfrSoftDownlinkDefaultConfiguration structure.
uint8_t dlBandwidth
DL bandwidth.
uint8_t dlEdgeSubBandOffset
DL edge subband offset.
uint8_t dlEdgeSubBandwidth
DL edge subbandwidth.
uint8_t dlCommonSubBandwidth
DL common subbandwidth.
FfrSoftUplinkDefaultConfiguration structure.
uint8_t ulCommonSubBandwidth
UL common subbandwidth.
uint8_t ulBandwidth
UL bandwidth.
uint8_t ulEdgeSubBandOffset
UL edge subband offset.
uint8_t ulEdgeSubBandwidth
edge subbandwidth
uint8_t rsrqResult
the RSRQ result
uint8_t rsrpResult
the RSRP result
MeasResultPCell measResultPCell
measurement result primary cell
PdschConfigDedicated structure.
Specifies criteria for triggering of an E-UTRA measurement reporting event.
@ EVENT_A1
Event A1: Serving 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.