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> 
   72   LteX2HandoverTestCase (uint32_t nUes, uint32_t nDedicatedBearers, std::list<HandoverEvent> handoverEventList, std::string handoverEventListName, 
bool useUdp, std::string schedulerType, 
bool admitHo, 
bool useIdealRrc);
 
   86   static std::string BuildNameString (uint32_t nUes, uint32_t nDedicatedBearers, std::string handoverEventListName, 
bool useUdp, std::string schedulerType, 
bool admitHo, 
bool useIdealRrc);
 
   87   virtual void DoRun (
void);
 
  138   void SaveStatsAfterHandover (uint32_t ueIndex);
 
  143   void CheckStatsAWhileAfterHandover (uint32_t ueIndex);
 
  155 std::string 
LteX2HandoverTestCase::BuildNameString (uint32_t nUes, uint32_t nDedicatedBearers, std::string handoverEventListName, 
bool useUdp, std::string schedulerType, 
bool admitHo, 
bool useIdealRrc)
 
  157   std::ostringstream oss;
 
  158   oss << 
" nUes=" << nUes 
 
  159       << 
" nDedicatedBearers=" << nDedicatedBearers 
 
  161       << 
" " << schedulerType
 
  162       << 
" admitHo=" << admitHo
 
  163       << 
" hoList: " << handoverEventListName;
 
  166       oss << 
", ideal RRC";
 
  175 LteX2HandoverTestCase::LteX2HandoverTestCase (uint32_t nUes, uint32_t nDedicatedBearers, std::list<HandoverEvent> handoverEventList, std::string handoverEventListName, 
bool useUdp, std::string schedulerType, 
bool admitHo, 
bool useIdealRrc)
 
  176   : 
TestCase (BuildNameString (nUes, nDedicatedBearers, handoverEventListName, useUdp, schedulerType, admitHo, useIdealRrc)),
 
  178     m_nDedicatedBearers (nDedicatedBearers),
 
  179     m_handoverEventList (handoverEventList),
 
  180     m_handoverEventListName (handoverEventListName),
 
  183     m_schedulerType (schedulerType),
 
  185     m_useIdealRrc (useIdealRrc),
 
  186     m_maxHoDuration (
Seconds (0.1)),
 
  187     m_statsDuration (
Seconds (0.1)),
 
  188     m_udpClientInterval (
Seconds (0.01)),
 
  189     m_udpClientPktSize (100)
 
  223       m_epcHelper = CreateObject<PointToPointEpcHelper> ();
 
  228   positionAlloc->
Add (Vector (-3000, 0, 0)); 
 
  229   positionAlloc->
Add (Vector ( 3000, 0, 0)); 
 
  230   for (uint16_t i = 0; i < 
m_nUes; i++)
 
  232       positionAlloc->
Add (Vector (0, 0, 0));
 
  244        it != enbDevices.
End ();
 
  263       remoteHostContainer.
Create (1);
 
  264       remoteHost = remoteHostContainer.
Get (0);
 
  266       internet.
Install (remoteHostContainer);
 
  276       ipv4h.
SetBase (
"1.0.0.0", 
"255.0.0.0");
 
  279       remoteHostAddr = internetIpIfaces.
GetAddress (1);
 
  302       uint16_t dlPort = 10000;
 
  303       uint16_t ulPort = 20000;
 
  313       for (uint32_t u = 0; u < ueNodes.
GetN (); ++u)
 
  336                       clientApps.
Add (dlClientHelper.Install (remoteHost));
 
  341                       serverApps.
Add (sinkContainer);
 
  352                       serverApps.
Add (sinkContainer);  
 
  362                       clientApps.
Add (dlClientHelper.
Install (remoteHost));
 
  367                       serverApps.
Add (sinkContainer);
 
  379                       serverApps.
Add (sinkContainer);  
 
  401                   EpsBearer bearer (EpsBearer::NGBR_VIDEO_TCP_DEFAULT);
 
  405               serverApps.
Start (startTime);
 
  406               clientApps.
Start (startTime);
 
  419       for (uint32_t u = 0; u < ueDevices.
GetN (); ++u)
 
  435   const Time maxRrcConnectionEstablishmentDuration = 
Seconds (0.080);
 
  438       Simulator::Schedule (maxRrcConnectionEstablishmentDuration, 
 
  440                            this, *it, enbDevices.
Get (0));
 
  450       Simulator::Schedule (hoEventIt->startTime, 
 
  453                            ueDevices.
Get (hoEventIt->ueDeviceIndex), 
 
  454                            enbDevices.
Get (hoEventIt->sourceEnbDeviceIndex));
 
  456                                     ueDevices.
Get (hoEventIt->ueDeviceIndex),
 
  457                                     enbDevices.
Get (hoEventIt->sourceEnbDeviceIndex),
 
  458                                     enbDevices.
Get (hoEventIt->targetEnbDeviceIndex));
 
  460       Simulator::Schedule (hoEndTime, 
 
  463                            ueDevices.
Get (hoEventIt->ueDeviceIndex), 
 
  464                            enbDevices.
Get (
m_admitHo ? hoEventIt->targetEnbDeviceIndex : hoEventIt->sourceEnbDeviceIndex));
 
  466                            this, hoEventIt->ueDeviceIndex);
 
  470                            this, hoEventIt->ueDeviceIndex);      
 
  471       if (stopTime <= checkStatsAfterHoTime)
 
  481   Simulator::Stop (stopTime);
 
  485   Simulator::Destroy ();
 
  499   uint16_t rnti = ueRrc->GetRnti ();
 
  505   NS_ASSERT_MSG (ueManagerState == UeManager::CONNECTED_NORMALLY, 
"Wrong UeManager state!");
 
  507   uint16_t ueCellId = ueRrc->GetCellId ();
 
  508   uint16_t enbCellId = enbLteDevice->GetCellId ();
 
  509   uint8_t ueDlBandwidth = ueRrc->GetDlBandwidth ();
 
  510   uint8_t enbDlBandwidth = enbLteDevice->GetDlBandwidth ();
 
  511   uint8_t ueUlBandwidth = ueRrc->GetUlBandwidth ();
 
  512   uint8_t enbUlBandwidth = enbLteDevice->GetUlBandwidth ();
 
  513   uint8_t ueDlEarfcn = ueRrc->GetDlEarfcn ();
 
  514   uint8_t enbDlEarfcn = enbLteDevice->GetDlEarfcn ();
 
  515   uint8_t ueUlEarfcn = ueRrc->GetUlEarfcn ();
 
  516   uint8_t enbUlEarfcn = enbLteDevice->GetUlEarfcn ();
 
  517   uint64_t ueImsi = ueLteDevice->
GetImsi ();
 
  518   uint64_t enbImsi = ueManager->
GetImsi ();
 
  528   ueManager->
GetAttribute (
"DataRadioBearerMap", enbDataRadioBearerMapValue);
 
  532   ueRrc->GetAttribute (
"DataRadioBearerMap", ueDataRadioBearerMapValue);
 
  537   while (enbBearerIt != enbDataRadioBearerMapValue.
End () &&
 
  538          ueBearerIt != ueDataRadioBearerMapValue.End ())
 
  552   NS_ASSERT_MSG (enbBearerIt == enbDataRadioBearerMapValue.
End (), 
"too many bearers at eNB");
 
  553   NS_ASSERT_MSG (ueBearerIt == ueDataRadioBearerMapValue.End (), 
"too many bearers at UE");  
 
  559   for (std::list<BearerData>::iterator it = 
m_ueDataVector.at (ueIndex).bearerDataList.begin ();
 
  563       it->dlOldTotalRx = it->dlSink->GetTotalRx ();
 
  564       it->ulOldTotalRx = it->ulSink->GetTotalRx ();
 
  572   for (std::list<BearerData>::iterator it = 
m_ueDataVector.at (ueIndex).bearerDataList.begin ();
 
  576       uint32_t dlRx = it->dlSink->GetTotalRx () - it->dlOldTotalRx;
 
  577       uint32_t ulRx = it->ulSink->GetTotalRx () - it->ulOldTotalRx;                       
 
  580       NS_TEST_ASSERT_MSG_GT (dlRx,   0.500 * expectedBytes, 
"too few RX bytes in DL, ue=" << ueIndex << 
", b=" << b);
 
  581       NS_TEST_ASSERT_MSG_GT (ulRx,   0.500 * expectedBytes, 
"too few RX bytes in UL, ue=" << ueIndex << 
", b=" << b);
 
  637   std::string hel0name (
"none");
 
  638   std::list<HandoverEvent> hel0;
 
  640   std::string hel1name (
"1 fwd");
 
  641   std::list<HandoverEvent> hel1;
 
  642   hel1.push_back (ue1fwd);
 
  644   std::string hel2name (
"1 fwd & bwd");
 
  645   std::list<HandoverEvent> hel2;
 
  646   hel2.push_back (ue1fwd);
 
  647   hel2.push_back (ue1bwd);
 
  649   std::string hel3name (
"1 fwd & bwd & fwd");
 
  650   std::list<HandoverEvent> hel3;
 
  651   hel3.push_back (ue1fwd);
 
  652   hel3.push_back (ue1bwd);
 
  653   hel3.push_back (ue1fwdagain);
 
  655   std::string hel4name (
"1+2 fwd");
 
  656   std::list<HandoverEvent> hel4;
 
  657   hel4.push_back (ue1fwd);
 
  658   hel4.push_back (ue2fwd);
 
  660   std::string hel5name (
"1+2 fwd & bwd");
 
  661   std::list<HandoverEvent> hel5;
 
  662   hel5.push_back (ue1fwd);
 
  663   hel5.push_back (ue1bwd);
 
  664   hel5.push_back (ue2fwd);
 
  665   hel5.push_back (ue2bwd);
 
  667   std::string hel6name (
"2 fwd");
 
  668   std::list<HandoverEvent> hel6;
 
  669   hel6.push_back (ue2fwd);
 
  671   std::string hel7name (
"2 fwd & bwd");
 
  672   std::list<HandoverEvent> hel7;
 
  673   hel7.push_back (ue2fwd);
 
  674   hel7.push_back (ue2bwd);
 
  676   std::vector<std::string> schedulers;
 
  677   schedulers.push_back (
"ns3::RrFfMacScheduler");
 
  678   schedulers.push_back (
"ns3::PfFfMacScheduler");
 
  679   for (std::vector<std::string>::iterator schedIt = schedulers.begin (); schedIt != schedulers.end (); ++schedIt)
 
  681       for (int32_t useIdealRrc = 1; useIdealRrc >= 0; --useIdealRrc)
 
Ptr< PacketSink > dlSink
DL sink. 
 
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
number of UEs in the test 
 
Simulation virtual time values and global simulation resolution. 
 
std::list< BearerData > bearerDataList
bearer ID list 
 
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. 
 
std::string m_handoverEventListName
handover event list name 
 
AttributeValue implementation for Boolean. 
 
NetDeviceContainer InstallEnbDevice(NodeContainer c)
Create a set of eNodeB devices. 
 
const uint32_t m_udpClientPktSize
UDP client packet size. 
 
A helper to make it easier to instantiate an ns3::BulkSendApplication on a set of nodes...
 
Ptr< LteHelper > m_lteHelper
LTE helper. 
 
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. 
 
Ptr< T > GetObject(void) const 
Get a pointer to the requested aggregated Object. 
 
Hold variables of type string. 
 
void HandoverRequest(Time hoTime, Ptr< NetDevice > ueDev, Ptr< NetDevice > sourceEnbDev, Ptr< NetDevice > targetEnbDev)
Manually trigger an X2-based handover. 
 
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< PacketSink > ulSink
UL sink. 
 
Ptr< LteUeRrc > GetRrc() const 
Get the RRC. 
 
uint64_t GetImsi() const 
Get the IMSI. 
 
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. 
 
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. 
 
static std::string BuildNameString(uint32_t nUes, uint32_t nDedicatedBearers, std::string handoverEventListName, bool useUdp, std::string schedulerType, bool admitHo, bool useIdealRrc)
Build name string. 
 
void ActivateDataRadioBearer(NetDeviceContainer ueDevices, EpsBearer bearer)
Activate a Data Radio Bearer on a given UE devices (for LTE-only simulation). 
 
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. 
 
uint32_t targetEnbDeviceIndex
target ENB device index 
 
bool m_useUdp
whether to use UDP traffic 
 
void SetHandoverAlgorithmType(std::string type)
Set the type of handover algorithm to be used by eNodeB devices. 
 
ApplicationContainer Install(NodeContainer c)
 
std::map< uint32_t, Ptr< Object > >::const_iterator Iterator
Iterator type for traversing this container. 
 
void SetSchedulerType(std::string type)
Set the type of scheduler to be used by eNodeB devices. 
 
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 
Get an approximation of the time stored in this instance in the indicated unit. 
 
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)
Save stats after handover function. 
 
NS_ASSERT_MSG(false,"Ipv4AddressGenerator::MaskToIndex(): Impossible")
 
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
logical channel identity 
 
Create a client application which sends UDP packets carrying a 32bit sequence number and a 64 bit tim...
 
uint32_t m_nUes
number of UEs in the test 
 
AttributeValue implementation for Time. 
 
uint32_t ueDeviceIndex
UE device index. 
 
void AddTestCase(TestCase *testCase, TestDuration duration=QUICK)
Add an individual child TestCase to this test suite. 
 
Lte X2 Handover Test Suite. 
 
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. 
 
bool m_admitHo
whether to admit the handover request 
 
std::string m_schedulerType
scheduler type 
 
holds a vector of ns3::NetDevice pointers 
 
static LteX2HandoverTestSuite g_lteX2HandoverTestSuiteInstance
 
std::vector< UeData > m_ueDataVector
UE data vector. 
 
const Time m_statsDuration
stats duration 
 
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
source ENB device index 
 
Access to the IPv4 forwarding table, interfaces, and configuration. 
 
std::list< HandoverEvent > m_handoverEventList
handover event list 
 
uint16_t remotePortEnd
end of the port number range of the remote host 
 
virtual Ipv4Address GetUeDefaultGatewayAddress()
 
bool m_useIdealRrc
whether to use the ideal RRC 
 
Every class exported by the ns3 library is enclosed in the ns3 namespace. 
 
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
UDP client interval. 
 
State
The state of the UeManager at the eNB RRC. 
 
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 
Get an iterator to the first Object. 
 
void GetAttribute(std::string name, AttributeValue &value) const 
Get the value of an attribute, raising fatal errors if unsuccessful. 
 
Ptr< PointToPointEpcHelper > m_epcHelper
EPC helper. 
 
uint64_t GetImsi(void) const 
 
void Reset(void)
Reset the initial value of every attribute as well as the value of every global to what they were bef...
 
void SetChannelAttribute(std::string name, const AttributeValue &value)
Set an attribute value to be propagated to each Channel created by the helper. 
 
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)
Check connected function. 
 
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
maximum HO duration 
 
void CheckStatsAWhileAfterHandover(uint32_t ueIndex)
Check stats a while after handover function. 
 
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...
 
uint8_t m_drbIdentity
DRB identity. 
 
Helper class that adds ns3::Ipv4StaticRouting objects. 
 
AttributeValue implementation for DataRate. 
 
Ptr< Node > Get(uint32_t i) const 
Get the Ptr stored in this container at a given index. 
 
Iterator End(void) const 
Get an iterator to the past-the-end Object. 
 
std::vector< Ptr< NetDevice > >::const_iterator Iterator
NetDevice container iterator. 
 
Time Seconds(double value)
Construct a Time in the indicated unit. 
 
uint32_t dlOldTotalRx
DL old total receive. 
 
void SetDefault(std::string name, const AttributeValue &value)
 
void Add(Vector v)
Add a position to the list of positions. 
 
uint32_t ulOldTotalRx
UL old total receive. 
 
bool m_epc
whether to use EPC 
 
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 
Get the number of Objects. 
 
Container for 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. 
 
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. 
 
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
EPS bearer identity. 
 
The LteUeNetDevice class implements the UE net device.