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 LteX2HandoverTestCase (uint32_t nUes, uint32_t nDedicatedBearers, std::list<HandoverEvent> handoverEventList, std::string handoverEventListName,
bool useUdp, std::string schedulerType,
bool admitHo,
bool useIdealRrc);
61 static std::string BuildNameString (uint32_t nUes, uint32_t nDedicatedBearers, std::string handoverEventListName,
bool useUdp, std::string schedulerType,
bool admitHo,
bool useIdealRrc);
62 virtual void DoRun (
void);
92 void SaveStatsAfterHandover (uint32_t ueIndex);
93 void CheckStatsAWhileAfterHandover (uint32_t ueIndex);
105 std::string
LteX2HandoverTestCase::BuildNameString (uint32_t nUes, uint32_t nDedicatedBearers, std::string handoverEventListName,
bool useUdp, std::string schedulerType,
bool admitHo,
bool useIdealRrc)
107 std::ostringstream oss;
108 oss <<
" nUes=" << nUes
109 <<
" nDedicatedBearers=" << nDedicatedBearers
111 <<
" " << schedulerType
112 <<
" admitHo=" << admitHo
113 <<
" hoList: " << handoverEventListName;
116 oss <<
", ideal RRC";
125 LteX2HandoverTestCase::LteX2HandoverTestCase (uint32_t nUes, uint32_t nDedicatedBearers, std::list<HandoverEvent> handoverEventList, std::string handoverEventListName,
bool useUdp, std::string schedulerType,
bool admitHo,
bool useIdealRrc)
126 :
TestCase (BuildNameString (nUes, nDedicatedBearers, handoverEventListName, useUdp, schedulerType, admitHo, useIdealRrc)),
128 m_nDedicatedBearers (nDedicatedBearers),
129 m_handoverEventList (handoverEventList),
130 m_handoverEventListName (handoverEventListName),
133 m_schedulerType (schedulerType),
135 m_useIdealRrc (useIdealRrc),
136 m_maxHoDuration (Seconds (0.1)),
137 m_statsDuration (Seconds (0.1)),
138 m_udpClientInterval (Seconds (0.01)),
139 m_udpClientPktSize (100)
170 m_epcHelper = CreateObject<PointToPointEpcHelper> ();
175 positionAlloc->
Add (
Vector (-3000, 0, 0));
176 positionAlloc->
Add (
Vector ( 3000, 0, 0));
177 for (uint16_t i = 0; i <
m_nUes; i++)
191 it != enbDevices.
End ();
210 remoteHostContainer.
Create (1);
211 remoteHost = remoteHostContainer.
Get (0);
213 internet.
Install (remoteHostContainer);
223 ipv4h.
SetBase (
"1.0.0.0",
"255.0.0.0");
226 remoteHostAddr = internetIpIfaces.
GetAddress (1);
249 uint16_t dlPort = 10000;
250 uint16_t ulPort = 20000;
260 for (uint32_t u = 0; u < ueNodes.
GetN (); ++u)
283 clientApps.
Add (dlClientHelper.Install (remoteHost));
288 serverApps.
Add (sinkContainer);
299 serverApps.
Add (sinkContainer);
309 clientApps.
Add (dlClientHelper.
Install (remoteHost));
314 serverApps.
Add (sinkContainer);
326 serverApps.
Add (sinkContainer);
348 EpsBearer bearer (EpsBearer::NGBR_VIDEO_TCP_DEFAULT);
352 serverApps.
Start (startTime);
353 clientApps.
Start (startTime);
366 for (uint32_t u = 0; u < ueDevices.
GetN (); ++u)
382 const Time maxRrcConnectionEstablishmentDuration = Seconds (0.080);
385 Simulator::Schedule (maxRrcConnectionEstablishmentDuration,
387 this, *it, enbDevices.
Get (0));
397 Simulator::Schedule (hoEventIt->startTime,
400 ueDevices.
Get (hoEventIt->ueDeviceIndex),
401 enbDevices.
Get (hoEventIt->sourceEnbDeviceIndex));
403 ueDevices.
Get (hoEventIt->ueDeviceIndex),
404 enbDevices.
Get (hoEventIt->sourceEnbDeviceIndex),
405 enbDevices.
Get (hoEventIt->targetEnbDeviceIndex));
407 Simulator::Schedule (hoEndTime,
410 ueDevices.
Get (hoEventIt->ueDeviceIndex),
411 enbDevices.
Get (
m_admitHo ? hoEventIt->targetEnbDeviceIndex : hoEventIt->sourceEnbDeviceIndex));
413 this, hoEventIt->ueDeviceIndex);
417 this, hoEventIt->ueDeviceIndex);
418 if (stopTime <= checkStatsAfterHoTime)
420 stopTime = checkStatsAfterHoTime + MilliSeconds (1);
428 Simulator::Stop (stopTime);
432 Simulator::Destroy ();
446 uint16_t rnti = ueRrc->GetRnti ();
452 NS_ASSERT_MSG (ueManagerState == UeManager::CONNECTED_NORMALLY,
"Wrong UeManager state!");
454 uint16_t ueCellId = ueRrc->GetCellId ();
455 uint16_t enbCellId = enbLteDevice->GetCellId ();
456 uint8_t ueDlBandwidth = ueRrc->GetDlBandwidth ();
457 uint8_t enbDlBandwidth = enbLteDevice->GetDlBandwidth ();
458 uint8_t ueUlBandwidth = ueRrc->GetUlBandwidth ();
459 uint8_t enbUlBandwidth = enbLteDevice->GetUlBandwidth ();
460 uint8_t ueDlEarfcn = ueRrc->GetDlEarfcn ();
461 uint8_t enbDlEarfcn = enbLteDevice->GetDlEarfcn ();
462 uint8_t ueUlEarfcn = ueRrc->GetUlEarfcn ();
463 uint8_t enbUlEarfcn = enbLteDevice->GetUlEarfcn ();
464 uint64_t ueImsi = ueLteDevice->
GetImsi ();
465 uint64_t enbImsi = ueManager->
GetImsi ();
475 ueManager->
GetAttribute (
"DataRadioBearerMap", enbDataRadioBearerMapValue);
479 ueRrc->GetAttribute (
"DataRadioBearerMap", ueDataRadioBearerMapValue);
484 while (enbBearerIt != enbDataRadioBearerMapValue.
End () &&
485 ueBearerIt != ueDataRadioBearerMapValue.End ())
499 NS_ASSERT_MSG (enbBearerIt == enbDataRadioBearerMapValue.
End (),
"too many bearers at eNB");
500 NS_ASSERT_MSG (ueBearerIt == ueDataRadioBearerMapValue.End (),
"too many bearers at UE");
506 for (std::list<BearerData>::iterator it =
m_ueDataVector.at (ueIndex).bearerDataList.begin ();
510 it->dlOldTotalRx = it->dlSink->GetTotalRx ();
511 it->ulOldTotalRx = it->ulSink->GetTotalRx ();
519 for (std::list<BearerData>::iterator it =
m_ueDataVector.at (ueIndex).bearerDataList.begin ();
523 uint32_t dlRx = it->dlSink->GetTotalRx () - it->dlOldTotalRx;
524 uint32_t ulRx = it->ulSink->GetTotalRx () - it->ulOldTotalRx;
527 NS_TEST_ASSERT_MSG_GT (dlRx, 0.500 * expectedBytes,
"too few RX bytes in DL, ue=" << ueIndex <<
", b=" << b);
528 NS_TEST_ASSERT_MSG_GT (ulRx, 0.500 * expectedBytes,
"too few RX bytes in UL, ue=" << ueIndex <<
", b=" << b);
561 ue1fwdagain.
startTime = MilliSeconds (500);
578 std::string hel0name (
"none");
579 std::list<HandoverEvent> hel0;
581 std::string hel1name (
"1 fwd");
582 std::list<HandoverEvent> hel1;
583 hel1.push_back (ue1fwd);
585 std::string hel2name (
"1 fwd & bwd");
586 std::list<HandoverEvent> hel2;
587 hel2.push_back (ue1fwd);
588 hel2.push_back (ue1bwd);
590 std::string hel3name (
"1 fwd & bwd & fwd");
591 std::list<HandoverEvent> hel3;
592 hel3.push_back (ue1fwd);
593 hel3.push_back (ue1bwd);
594 hel3.push_back (ue1fwdagain);
596 std::string hel4name (
"1+2 fwd");
597 std::list<HandoverEvent> hel4;
598 hel4.push_back (ue1fwd);
599 hel4.push_back (ue2fwd);
601 std::string hel5name (
"1+2 fwd & bwd");
602 std::list<HandoverEvent> hel5;
603 hel5.push_back (ue1fwd);
604 hel5.push_back (ue1bwd);
605 hel5.push_back (ue2fwd);
606 hel5.push_back (ue2bwd);
608 std::string hel6name (
"2 fwd");
609 std::list<HandoverEvent> hel6;
610 hel6.push_back (ue2fwd);
612 std::string hel7name (
"2 fwd & bwd");
613 std::list<HandoverEvent> hel7;
614 hel7.push_back (ue2fwd);
615 hel7.push_back (ue2bwd);
617 std::vector<std::string> schedulers;
618 schedulers.push_back (
"ns3::RrFfMacScheduler");
619 schedulers.push_back (
"ns3::PfFfMacScheduler");
620 for (std::vector<std::string>::iterator schedIt = schedulers.begin (); schedIt != schedulers.end (); ++schedIt)
622 for (int32_t useIdealRrc = 1; useIdealRrc >= 0; --useIdealRrc)
holds a vector of ns3::Application pointers.
Iterator Begin(void) const
Get an iterator which refers to the first NetDevice in the container.
uint8_t Add(PacketFilter f)
add a PacketFilter to the Traffic Flow Template
uint32_t m_nDedicatedBearers
Simulation virtual time values and global simulation resolution.
std::list< BearerData > bearerDataList
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 this RNG stream.
std::string m_handoverEventListName
State
The state of the UeManager at the eNB RRC.
NetDeviceContainer InstallEnbDevice(NodeContainer c)
create a set of eNB devices
const uint32_t m_udpClientPktSize
A helper to make it easier to instantiate an ns3::BulkSendApplication on a set of nodes...
Ptr< LteHelper > m_lteHelper
holds a vector of std::pair of Ptr and interface index.
void SetDefaultRoute(Ipv4Address nextHop, uint32_t interface, uint32_t metric=0)
Add a default route to the static routing table.
void Reset(void)
Reset the initial value of every attribute as well as the value of every global to what they were bef...
hold variables of type string
void HandoverRequest(Time hoTime, Ptr< NetDevice > ueDev, Ptr< NetDevice > sourceEnbDev, Ptr< NetDevice > targetEnbDev)
Manually trigger an X2-based handover of a UE between two eNBs at a specific simulation time...
Ptr< NetDevice > Get(uint32_t i) const
Get the Ptr stored in this container at a given index.
NetDeviceContainer Install(NodeContainer c)
a class to represent an Ipv4 address mask
void Add(ApplicationContainer other)
Append the contents of another ApplicationContainer to the end of this container. ...
virtual Ptr< Node > GetPgwNode()
Ptr< LteUeRrc > GetRrc() const
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.
aggregate IP/TCP/UDP functionality to existing Nodes.
uint16_t localPortEnd
end of the port number range of the UE
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 by this model...
static std::string BuildNameString(uint32_t nUes, uint32_t nDedicatedBearers, std::string handoverEventListName, bool useUdp, std::string schedulerType, bool admitHo, bool useIdealRrc)
void ActivateDataRadioBearer(NetDeviceContainer ueDevices, EpsBearer bearer)
Call ActivateDataRadioBearer (ueDevice, bearer) for each UE device in a given set.
void SetDeviceAttribute(std::string name, const AttributeValue &value)
Set an attribute value to be propagated to each NetDevice created by the helper.
uint32_t targetEnbDeviceIndex
void SetHandoverAlgorithmType(std::string type)
ApplicationContainer Install(NodeContainer c)
std::map< uint32_t, Ptr< Object > >::const_iterator Iterator
void SetSchedulerType(std::string type)
uint32_t GetN(void) const
Get the number of Ptr stored in this container.
uint32_t GetN(void) const
Get the number of Ptr stored in this container.
Class for representing data rates.
double GetSeconds(void) const
ApplicationContainer Install(NodeContainer c) const
Install an ns3::BulkSendApplication on each node of the input container configured with all the attri...
This class contains the specification of EPS Bearers.
LteX2HandoverTestCase(uint32_t nUes, uint32_t nDedicatedBearers, std::list< HandoverEvent > handoverEventList, std::string handoverEventListName, bool useUdp, std::string schedulerType, bool admitHo, bool useIdealRrc)
void SaveStatsAfterHandover(uint32_t ueIndex)
void Install(Ptr< Node > node) const
"Layout" a single node according to the current position allocator type.
store information on active data radio bearer instance
uint8_t m_logicalChannelIdentity
Create a client application which sends UDP packets carrying a 32bit sequence number and a 64 bit tim...
hold objects of type ns3::Time
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::string m_schedulerType
holds a vector of ns3::NetDevice pointers
static LteX2HandoverTestSuite g_lteX2HandoverTestSuiteInstance
std::vector< UeData > m_ueDataVector
const Time m_statsDuration
void Start(Time start)
Arrange for all of the Applications in this container to Start() at the Time given as a parameter...
uint32_t sourceEnbDeviceIndex
Access to the Ipv4 forwarding table, interfaces, and configuration.
std::list< HandoverEvent > m_handoverEventList
uint16_t remotePortEnd
end of the port number range of the remote host
void SetDefault(std::string name, const AttributeValue &value)
void ActivateDedicatedEpsBearer(NetDeviceContainer ueDevices, EpsBearer bearer, Ptr< EpcTft > tft)
Activate a dedicated EPS bearer on a given set of UE devices.
virtual Ipv4Address GetUeDefaultGatewayAddress()
keep track of a set of node pointers.
Ptr< Application > Get(uint32_t i) const
Get the Ptr
stored in this container at a given index.
const Time m_udpClientInterval
virtual void DoRun(void)
Implementation to actually run this TestCase.
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 Install(std::string nodeName) const
Aggregate implementations of the ns3::Ipv4, ns3::Ipv6, ns3::Udp, and ns3::Tcp classes onto the provid...
void AddX2Interface(NodeContainer enbNodes)
Create an X2 interface between all the eNBs in a given set.
Iterator Begin(void) const
void GetAttribute(std::string name, AttributeValue &value) const
void AddTestCase(TestCase *testCase) NS_DEPRECATED
Add an individual child TestCase case to this TestCase.
Ptr< PointToPointEpcHelper > m_epcHelper
uint64_t GetImsi(void) const
void SetChannelAttribute(std::string name, const AttributeValue &value)
Set an attribute value to be propagated to each Channel created by the helper.
#define NS_ASSERT_MSG(condition, message)
At runtime, in debugging builds, if this condition is not true, the program prints the message to out...
NetDeviceContainer InstallUeDevice(NodeContainer c)
create a set of UE devices
virtual Ipv4InterfaceContainer AssignUeIpv4Address(NetDeviceContainer ueDevices)
Assign IPv4 addresses to UE devices.
void CheckConnected(Ptr< NetDevice > ueDevice, Ptr< NetDevice > enbDevice)
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.
const Time m_maxHoDuration
void CheckStatsAWhileAfterHandover(uint32_t ueIndex)
Ipv4InterfaceContainer Assign(const NetDeviceContainer &c)
Assign IP addresses to the net devices specified in the container based on the current network prefix...
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 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...
Helper class that adds ns3::Ipv4StaticRouting objects.
hold objects of type ns3::DataRate
Ptr< Node > Get(uint32_t i) const
Get the Ptr stored in this container at a given index.
std::vector< Ptr< NetDevice > >::const_iterator Iterator
NetDevice container iterator.
ApplicationContainer Install(NodeContainer c) const
Install an ns3::PacketSinkApplication on each node of the input container configured with all the att...
A helper class to make life easier while doing simple IPv4 address assignment in scripts.
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...
uint32_t GetN(void) const
contain a set of ns3::Object pointers.
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...
Iterator End(void) const
Get an iterator which indicates past-the-last NetDevice in the container.
#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.
Hold a floating point type.
void SetAttribute(std::string name, const AttributeValue &value)
The eNodeB device implementation.
Ptr< T > GetObject(void) const
uint16_t remotePortStart
start of the port number range of the remote host
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.
Ipv4Address GetAddress(uint32_t i, uint32_t j=0) const
uint16_t localPortStart
start of the port number range of the UE
uint8_t m_epsBearerIdentity
The LteUeNetDevice class implements the UE net device.