22 #include <ns3/core-module.h> 23 #include <ns3/network-module.h> 24 #include <ns3/mobility-module.h> 25 #include <ns3/lte-module.h> 26 #include <ns3/internet-module.h> 27 #include <ns3/applications-module.h> 28 #include <ns3/point-to-point-module.h> 58 : checkStartTime (
start),
60 checkInterval (interval),
61 ueDeviceIndex (ueIndex),
62 enbDeviceIndex (enbIndex)
95 std::list<CheckPointEvent> checkPointEventList,
96 std::string checkPointEventListName,
97 bool useUdp, std::string schedulerType,
98 std::string handoverAlgorithmType,
bool admitHo,
115 static std::string BuildNameString (uint32_t nEnbs, uint32_t nUes, uint32_t nDedicatedBearers,
116 std::string checkPointEventListName,
117 bool useUdp, std::string schedulerType,
118 std::string handoverAlgorithmType,
bool admitHo,
120 virtual void DoRun (
void);
173 void SaveStats (uint32_t ueIndex);
178 void CheckStats (uint32_t ueIndex);
191 std::string checkPointEventListName,
192 bool useUdp, std::string schedulerType,
193 std::string handoverAlgorithmType,
bool admitHo,
196 std::ostringstream oss;
197 oss <<
"nEnbs=" << nEnbs
199 <<
" nDedicatedBearers=" << nDedicatedBearers
201 <<
" " << schedulerType
202 <<
" " << handoverAlgorithmType
203 <<
" admitHo=" << admitHo
204 <<
" hoList: " << checkPointEventListName;
207 oss <<
", ideal RRC";
217 std::list<CheckPointEvent> checkPointEventList,
218 std::string checkPointEventListName,
219 bool useUdp, std::string schedulerType,
220 std::string handoverAlgorithmType,
bool admitHo,
222 :
TestCase (BuildNameString (nEnbs, nUes, nDedicatedBearers,
223 checkPointEventListName, useUdp, schedulerType,
224 handoverAlgorithmType, admitHo, useIdealRrc)),
227 m_nDedicatedBearers (nDedicatedBearers),
228 m_checkPointEventList (checkPointEventList),
229 m_checkPointEventListName (checkPointEventListName),
232 m_schedulerType (schedulerType),
233 m_handoverAlgorithmType (handoverAlgorithmType),
235 m_useIdealRrc (useIdealRrc),
236 m_maxHoDuration (
Seconds (0.1)),
237 m_statsDuration (
Seconds (0.5)),
238 m_udpClientInterval (
Seconds (0.01)),
239 m_udpClientPktSize (100)
290 double distance = 1000.0;
300 m_epcHelper = CreateObject<PointToPointEpcHelper> ();
307 for (uint16_t i = 0; i <
m_nEnbs; i++)
309 Vector enbPosition (distance * (i + 1), 0, 0);
310 enbPositionAlloc->
Add (enbPosition);
315 enbMobility.
Install (enbNodes);
322 for (uint16_t i = 0; i <
m_nUes; i++)
332 it != enbDevices.
End ();
351 remoteHostContainer.
Create (1);
352 remoteHost = remoteHostContainer.
Get (0);
354 internet.
Install (remoteHostContainer);
364 ipv4h.
SetBase (
"1.0.0.0",
"255.0.0.0");
367 remoteHostAddr = internetIpIfaces.
GetAddress (1);
390 uint16_t dlPort = 10000;
391 uint16_t ulPort = 20000;
401 for (uint32_t u = 0; u < ueNodes.
GetN (); ++u)
424 clientApps.Add (dlClientHelper.Install (remoteHost));
489 EpsBearer bearer (EpsBearer::NGBR_VIDEO_TCP_DEFAULT);
507 for (uint32_t u = 0; u < ueDevices.
GetN (); ++u)
523 const Time maxRrcConnectionEstablishmentDuration =
Seconds (0.080);
527 Simulator::Schedule (maxRrcConnectionEstablishmentDuration,
529 this, *it, enbDevices.
Get (0));
539 for (
Time checkPointTime = checkPointEventIt->checkStartTime;
540 checkPointTime < checkPointEventIt->checkStopTime;
541 checkPointTime += checkPointEventIt->checkInterval)
544 this, ueDevices.
Get (checkPointEventIt->ueDeviceIndex),
545 enbDevices.
Get (checkPointEventIt->enbDeviceIndex));
547 Time saveStatsTime = checkPointTime;
549 this, checkPointEventIt->ueDeviceIndex);
553 this, checkPointEventIt->ueDeviceIndex);
564 Simulator::Destroy ();
579 uint16_t rnti = ueRrc->GetRnti ();
585 NS_ASSERT_MSG (ueManagerState == UeManager::CONNECTED_NORMALLY,
"Wrong UeManager state!");
587 uint16_t ueCellId = ueRrc->GetCellId ();
588 uint16_t enbCellId = enbLteDevice->GetCellId ();
589 uint8_t ueDlBandwidth = ueRrc->GetDlBandwidth ();
590 uint8_t enbDlBandwidth = enbLteDevice->GetDlBandwidth ();
591 uint8_t ueUlBandwidth = ueRrc->GetUlBandwidth ();
592 uint8_t enbUlBandwidth = enbLteDevice->GetUlBandwidth ();
593 uint8_t ueDlEarfcn = ueRrc->GetDlEarfcn ();
594 uint8_t enbDlEarfcn = enbLteDevice->GetDlEarfcn ();
595 uint8_t ueUlEarfcn = ueRrc->GetUlEarfcn ();
596 uint8_t enbUlEarfcn = enbLteDevice->GetUlEarfcn ();
597 uint64_t ueImsi = ueLteDevice->
GetImsi ();
598 uint64_t enbImsi = ueManager->
GetImsi ();
608 ueManager->
GetAttribute (
"DataRadioBearerMap", enbDataRadioBearerMapValue);
612 ueRrc->GetAttribute (
"DataRadioBearerMap", ueDataRadioBearerMapValue);
617 while (enbBearerIt != enbDataRadioBearerMapValue.
End ()
618 && ueBearerIt != ueDataRadioBearerMapValue.End ())
632 NS_ASSERT_MSG (enbBearerIt == enbDataRadioBearerMapValue.
End (),
"too many bearers at eNB");
633 NS_ASSERT_MSG (ueBearerIt == ueDataRadioBearerMapValue.End (),
"too many bearers at UE");
640 for (std::list<BearerData>::iterator it =
m_ueDataVector.at (ueIndex).bearerDataList.begin ();
646 it->dlOldTotalRx = it->dlSink->GetTotalRx ();
650 it->ulOldTotalRx = it->ulSink->GetTotalRx ();
660 for (std::list<BearerData>::iterator it =
m_ueDataVector.at (ueIndex).bearerDataList.begin ();
669 dlRx = it->dlSink->GetTotalRx () - it->dlOldTotalRx;
674 ulRx = it->ulSink->GetTotalRx () - it->ulOldTotalRx;
678 NS_LOG_LOGIC (
"expBytes " << expectedBytes <<
" dlRx " << dlRx <<
" ulRx " << ulRx);
683 NS_TEST_ASSERT_MSG_GT (dlRx, 0.500 * expectedBytes,
"too few RX bytes in DL, ue=" << ueIndex <<
", b=" << b);
687 NS_TEST_ASSERT_MSG_GT (ulRx, 0.500 * expectedBytes,
"too few RX bytes in UL, ue=" << ueIndex <<
", b=" << b);
708 :
TestSuite (
"lte-x2-handover-measures", SYSTEM)
712 std::string cel1name (
"ho: 0 -> 1");
713 std::list<CheckPointEvent> cel1;
717 std::string cel2name (
"ho: 0 -> 1 -> 2");
718 std::list<CheckPointEvent> cel2;
723 std::string cel3name (
"ho: 0 -> 1 -> 2 -> 3");
724 std::list<CheckPointEvent> cel3;
732 std::string sched =
"ns3::PfFfMacScheduler";
733 std::string ho =
"ns3::A2A4RsrqHandoverAlgorithm";
734 for (useIdealRrc = 1; useIdealRrc >= 0; --useIdealRrc)
737 AddTestCase (
new LteX2HandoverMeasuresTestCase (2, 1, 0, cel1, cel1name,
true, sched, ho,
true, useIdealRrc), TestCase::TAKES_FOREVER);
738 AddTestCase (
new LteX2HandoverMeasuresTestCase (2, 1, 1, cel1, cel1name,
true, sched, ho,
true, useIdealRrc), TestCase::QUICK);
739 AddTestCase (
new LteX2HandoverMeasuresTestCase (2, 1, 2, cel1, cel1name,
true, sched, ho,
true, useIdealRrc), TestCase::TAKES_FOREVER);
740 AddTestCase (
new LteX2HandoverMeasuresTestCase (3, 1, 0, cel2, cel2name,
true, sched, ho,
true, useIdealRrc), TestCase::TAKES_FOREVER);
741 AddTestCase (
new LteX2HandoverMeasuresTestCase (3, 1, 1, cel2, cel2name,
true, sched, ho,
true, useIdealRrc), TestCase::TAKES_FOREVER);
742 AddTestCase (
new LteX2HandoverMeasuresTestCase (3, 1, 2, cel2, cel2name,
true, sched, ho,
true, useIdealRrc), TestCase::EXTENSIVE);
743 AddTestCase (
new LteX2HandoverMeasuresTestCase (4, 1, 0, cel3, cel3name,
true, sched, ho,
true, useIdealRrc), TestCase::EXTENSIVE);
744 AddTestCase (
new LteX2HandoverMeasuresTestCase (4, 1, 1, cel3, cel3name,
true, sched, ho,
true, useIdealRrc), TestCase::TAKES_FOREVER);
745 AddTestCase (
new LteX2HandoverMeasuresTestCase (4, 1, 2, cel3, cel3name,
true, sched, ho,
true, useIdealRrc), TestCase::TAKES_FOREVER);
748 sched =
"ns3::RrFfMacScheduler";
749 for (useIdealRrc = 1; useIdealRrc >= 0; --useIdealRrc)
752 AddTestCase (
new LteX2HandoverMeasuresTestCase (2, 1, 0, cel1, cel1name,
true, sched, ho,
true, useIdealRrc), TestCase::EXTENSIVE);
753 AddTestCase (
new LteX2HandoverMeasuresTestCase (3, 1, 0, cel2, cel2name,
true, sched, ho,
true, useIdealRrc), TestCase::TAKES_FOREVER);
754 AddTestCase (
new LteX2HandoverMeasuresTestCase (4, 1, 0, cel3, cel3name,
true, sched, ho,
true, useIdealRrc), TestCase::TAKES_FOREVER);
757 ho =
"ns3::A3RsrpHandoverAlgorithm";
758 sched =
"ns3::PfFfMacScheduler";
759 for (useIdealRrc = 1; useIdealRrc >= 0; --useIdealRrc)
762 AddTestCase (
new LteX2HandoverMeasuresTestCase (2, 1, 0, cel1, cel1name,
true, sched, ho,
true, useIdealRrc), TestCase::EXTENSIVE);
763 AddTestCase (
new LteX2HandoverMeasuresTestCase (3, 1, 0, cel2, cel2name,
true, sched, ho,
true, useIdealRrc), TestCase::TAKES_FOREVER);
764 AddTestCase (
new LteX2HandoverMeasuresTestCase (4, 1, 0, cel3, cel3name,
true, sched, ho,
true, useIdealRrc), TestCase::TAKES_FOREVER);
767 sched =
"ns3::RrFfMacScheduler";
768 for (useIdealRrc = 1; useIdealRrc >= 0; --useIdealRrc)
771 AddTestCase (
new LteX2HandoverMeasuresTestCase (2, 1, 0, cel1, cel1name,
true, sched, ho,
true, useIdealRrc), TestCase::QUICK);
772 AddTestCase (
new LteX2HandoverMeasuresTestCase (3, 1, 0, cel2, cel2name,
true, sched, ho,
true, useIdealRrc), TestCase::TAKES_FOREVER);
773 AddTestCase (
new LteX2HandoverMeasuresTestCase (4, 1, 0, cel3, cel3name,
true, sched, ho,
true, useIdealRrc), TestCase::EXTENSIVE);
uint32_t ulOldTotalRx
UL old total receive.
holds a vector of ns3::Application pointers.
void CheckStats(uint32_t ueIndex)
Check stats function.
uint8_t Add(PacketFilter f)
add a PacketFilter to the Traffic Flow Template
Ptr< NetDevice > Get(uint32_t i) const
Get the Ptr<NetDevice> stored in this container at a given index.
Simulation virtual time values and global simulation resolution.
Smart pointer class similar to boost::intrusive_ptr.
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by "...
void SetStream(int64_t stream)
Specifies the stream number for the RngStream.
State
The state of the UeManager at the eNB RRC.
AttributeValue implementation for Boolean.
NetDeviceContainer InstallEnbDevice(NodeContainer c)
Create a set of eNodeB devices.
A helper to make it easier to instantiate an ns3::BulkSendApplication on a set of nodes...
Ptr< PointToPointEpcHelper > m_epcHelper
EPC helper.
holds a vector of std::pair of Ptr<Ipv4> and interface index.
void SetDefaultRoute(Ipv4Address nextHop, uint32_t interface, uint32_t metric=0)
Add a default route to the static routing table.
Iterator End(void) const
Get an iterator which indicates past-the-last NetDevice in the container.
NS_ASSERT_MSG(false, "Ipv4AddressGenerator::MaskToIndex(): Impossible")
Hold variables of type string.
NetDeviceContainer Install(NodeContainer c)
a class to represent an Ipv4 address mask
const uint32_t m_udpClientPktSize
UDP client packet size.
Test different X2 handover measures and algorithms, e.g.
virtual Ptr< Node > GetPgwNode()
double GetSeconds(void) const
Get an approximation of the time stored in this instance in the indicated unit.
Ptr< PacketSink > ulSink
UL sink.
Time checkStopTime
check stop time
void Attach(NetDeviceContainer ueDevices)
Enables automatic attachment of a set of UE devices to a suitable cell using Idle mode initial cell s...
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Time MilliSeconds(uint64_t value)
Construct a Time in the indicated unit.
ApplicationContainer Install(NodeContainer c) const
Install an ns3::PacketSinkApplication on each node of the input container configured with all the att...
aggregate IP/TCP/UDP functionality to existing Nodes.
uint16_t localPortEnd
end of the port number range of the UE
ApplicationContainer Install(NodeContainer c) const
Install an ns3::BulkSendApplication on each node of the input container configured with all the attri...
uint64_t GetImsi(void) const
const Time m_statsDuration
stats duration
#define NS_FATAL_ERROR(msg)
Report a fatal error with a message and terminate.
A helper to make it easier to instantiate an ns3::PacketSinkApplication on a set of nodes...
Build a set of PointToPointNetDevice objects.
int64_t AssignStreams(NetDeviceContainer c, int64_t stream)
Assign a fixed random variable stream number to the random variables used.
void ActivateDataRadioBearer(NetDeviceContainer ueDevices, EpsBearer bearer)
Activate a Data Radio Bearer on a given UE devices (for LTE-only simulation).
uint32_t ueDeviceIndex
UE device index.
void SetDeviceAttribute(std::string name, const AttributeValue &value)
Set an attribute value to be propagated to each NetDevice created by the helper.
uint8_t ActivateDedicatedEpsBearer(NetDeviceContainer ueDevices, EpsBearer bearer, Ptr< EpcTft > tft)
Activate a dedicated EPS bearer on a given set of UE devices.
void SetHandoverAlgorithmType(std::string type)
Set the type of handover algorithm to be used by eNodeB devices.
ApplicationContainer Install(NodeContainer c)
static void SetPosition(Ptr< Node > node, Vector position)
void SetSchedulerType(std::string type)
Set the type of scheduler to be used by eNodeB devices.
Class for representing data rates.
uint32_t m_nEnbs
number of eNBs in the test
Keep track of the current position and velocity of an object.
uint64_t GetImsi() const
Get the IMSI.
uint32_t dlOldTotalRx
DL old total receive.
This class contains the specification of EPS Bearers.
LteX2HandoverMeasuresTestCase(uint32_t nEnbs, uint32_t nUes, uint32_t nDedicatedBearers, std::list< CheckPointEvent > checkPointEventList, std::string checkPointEventListName, bool useUdp, std::string schedulerType, std::string handoverAlgorithmType, bool admitHo, bool useIdealRrc)
store information on active data radio bearer instance
void SetHandoverAlgorithmAttribute(std::string n, const AttributeValue &v)
Set an attribute for the handover algorithm to be created.
uint8_t m_logicalChannelIdentity
logical channel identity
Create a client application which sends UDP packets carrying a 32bit sequence number and a 64 bit tim...
AttributeValue implementation for Time.
void AddTestCase(TestCase *testCase, TestDuration duration=QUICK)
Add an individual child TestCase to this test suite.
Ipv4Address GetAddress(uint32_t i, uint32_t j=0) const
Iterator Begin(void) const
Get an iterator which refers to the first NetDevice in the container.
std::list< CheckPointEvent > m_checkPointEventList
check point event list
Iterator Begin(void) const
Get an iterator to the first Object.
Hold an unsigned integer type.
#define NS_TEST_ASSERT_MSG_EQ(actual, limit, msg)
Test that an actual and expected (limit) value are equal and report and abort if not.
std::map< std::size_t, Ptr< Object > >::const_iterator Iterator
Iterator type for traversing this container.
holds a vector of ns3::NetDevice pointers
Time checkInterval
check interval
Iterator End(void) const
Get an iterator to the past-the-end Object.
virtual void DoRun(void)
Implementation to actually run this TestCase.
CheckPointEvent structure.
std::string m_checkPointEventListName
check point event list name
std::size_t GetN(void) const
Get the number of Objects.
LteX2HandoverMeasuresTestSuite()
std::string m_handoverAlgorithmType
handover algorithm type
void SaveStats(uint32_t ueIndex)
Save stats function.
uint32_t GetN(void) const
Get the number of Ptr<Node> stored in this container.
bool m_useUdp
whether to use UDP traffic
Access to the IPv4 forwarding table, interfaces, and configuration.
Ptr< T > GetObject(void) const
Get a pointer to the requested aggregated Object.
bool m_admitHo
whether to configure to admit handover
uint16_t remotePortEnd
end of the port number range of the remote host
std::string m_schedulerType
scheduler type
virtual Ipv4Address GetUeDefaultGatewayAddress()
static LteX2HandoverMeasuresTestSuite g_lteX2HandoverMeasuresTestSuiteInstance
Every class exported by the ns3 library is enclosed in the ns3 namespace.
keep track of a set of node pointers.
void SetMobilityModel(std::string type, std::string n1="", const AttributeValue &v1=EmptyAttributeValue(), std::string n2="", const AttributeValue &v2=EmptyAttributeValue(), std::string n3="", const AttributeValue &v3=EmptyAttributeValue(), std::string n4="", const AttributeValue &v4=EmptyAttributeValue(), std::string n5="", const AttributeValue &v5=EmptyAttributeValue(), std::string n6="", const AttributeValue &v6=EmptyAttributeValue(), std::string n7="", const AttributeValue &v7=EmptyAttributeValue(), std::string n8="", const AttributeValue &v8=EmptyAttributeValue(), std::string n9="", const AttributeValue &v9=EmptyAttributeValue())
void AddX2Interface(NodeContainer enbNodes)
Create an X2 interface between all the eNBs in a given set.
NS_LOG_LOGIC("Net device "<< nd<< " is not bridged")
void Reset(void)
Reset the initial value of every attribute as well as the value of every global to what they were bef...
static std::string BuildNameString(uint32_t nEnbs, uint32_t nUes, uint32_t nDedicatedBearers, std::string checkPointEventListName, bool useUdp, std::string schedulerType, std::string handoverAlgorithmType, bool admitHo, bool useIdealRrc)
Build name string.
std::list< BearerData > bearerDataList
bearer ID list
void SetChannelAttribute(std::string name, const AttributeValue &value)
Set an attribute value to be propagated to each Channel created by the helper.
void Install(Ptr< Node > node) const
"Layout" a single node according to the current position allocator type.
void Install(std::string nodeName) const
Aggregate implementations of the ns3::Ipv4, ns3::Ipv6, ns3::Udp, and ns3::Tcp classes onto the provid...
NetDeviceContainer InstallUeDevice(NodeContainer c)
Create a set of UE devices.
virtual Ipv4InterfaceContainer AssignUeIpv4Address(NetDeviceContainer ueDevices)
Assign IPv4 addresses to UE devices.
Helper class used to assign positions and mobility models to nodes.
void AddNetworkRouteTo(Ipv4Address network, Ipv4Mask networkMask, Ipv4Address nextHop, uint32_t interface, uint32_t metric=0)
Add a network route to the static routing table.
Ipv4 addresses are stored in host order in this class.
Ipv4InterfaceContainer Assign(const NetDeviceContainer &c)
Assign IP addresses to the net devices specified in the container based on the current network prefix...
void SetEpcHelper(Ptr< EpcHelper > h)
Set the EpcHelper to be used to setup the EPC network in conjunction with the setup of the LTE radio ...
#define NS_TEST_ASSERT_MSG_NE(actual, limit, msg)
Test that an actual and expected (limit) value are not equal and report and abort if not...
Lte X2 Handover Measures Test Suite.
uint8_t m_drbIdentity
DRB identity.
Helper class that adds ns3::Ipv4StaticRouting objects.
AttributeValue implementation for DataRate.
bool m_epc
whether to use EPC
std::vector< UeData > m_ueDataVector
UE data vector.
uint32_t m_nDedicatedBearers
number of UEs in the test
std::vector< Ptr< NetDevice > >::const_iterator Iterator
NetDevice container iterator.
Time Seconds(double value)
Construct a Time in the indicated unit.
uint32_t GetN(void) const
Get the number of Ptr<NetDevice> stored in this container.
bool m_useIdealRrc
whether to use ideal RRC
void SetDefault(std::string name, const AttributeValue &value)
void Add(Vector v)
Add a position to the list of positions.
Time checkStartTime
check start time
CheckPointEvent(Time start, Time stop, Time interval, uint32_t ueIndex, uint32_t enbIndex)
Constructor.
uint32_t m_nUes
number of UEs in the test
Ptr< LteUeRrc > GetRrc() const
Get the RRC.
Ptr< Node > Get(uint32_t i) const
Get the Ptr<Node> stored in this container at a given index.
Mobility model for which the current speed does not change once it has been set and until it is set a...
A helper class to make life easier while doing simple IPv4 address assignment in scripts.
const Time m_udpClientInterval
UDP client interval.
uint32_t enbDeviceIndex
ENB device index.
void Create(uint32_t n)
Create n nodes and append pointers to them to the end of this NodeContainer.
void SetAttribute(std::string name, const AttributeValue &value)
Helper function used to set the underlying application attributes, not the socket attributes...
Container for a set of ns3::Object pointers.
Ptr< LteHelper > m_lteHelper
LTE helper.
Receive and consume traffic generated to an IP address and port.
void SetPositionAllocator(Ptr< PositionAllocator > allocator)
Set the position allocator which will be used to allocate the initial position of every node initiali...
#define NS_TEST_ASSERT_MSG_GT(actual, limit, msg)
Test that an actual value is greater than a limit and report and abort if not.
This class can be used to hold variables of floating point type such as 'double' or 'float'...
void SetAttribute(std::string name, const AttributeValue &value)
Set a single attribute, raising fatal errors if unsuccessful.
The eNodeB device implementation.
const Time m_maxHoDuration
maximum HO duration
void GetAttribute(std::string name, AttributeValue &value) const
Get the value of an attribute, raising fatal errors if unsuccessful.
Ptr< Application > Get(uint32_t i) const
Get the Ptr<Application> stored in this container at a given index.
Ptr< PacketSink > dlSink
DL sink.
uint16_t remotePortStart
start of the port number range of the remote host
Ptr< Ipv4StaticRouting > GetStaticRouting(Ptr< Ipv4 > ipv4) const
Try and find the static routing protocol as either the main routing protocol or in the list of routin...
void CheckConnected(Ptr< NetDevice > ueDevice, Ptr< NetDevice > enbDevice)
Check connected function.
void SetBase(Ipv4Address network, Ipv4Mask mask, Ipv4Address base="0.0.0.1")
Set the base network number, network mask and base address.
Implement the data structure representing a TrafficFlowTemplate Packet Filter.
uint16_t localPortStart
start of the port number range of the UE
uint8_t m_epsBearerIdentity
EPS bearer identity.
The LteUeNetDevice class implements the UE net device.