21#include <ns3/bulk-send-helper.h>
22#include <ns3/core-module.h>
23#include <ns3/internet-module.h>
24#include <ns3/lte-module.h>
25#include <ns3/mobility-module.h>
26#include <ns3/network-module.h>
27#include <ns3/packet-sink-helper.h>
28#include <ns3/packet-sink.h>
29#include <ns3/point-to-point-module.h>
30#include <ns3/udp-client-server-helper.h>
95 std::list<CheckPointEvent> checkPointEventList,
96 std::string checkPointEventListName,
98 std::string schedulerType,
99 std::string handoverAlgorithmType,
121 std::string checkPointEventListName,
123 std::string schedulerType,
124 std::string handoverAlgorithmType,
127 void DoRun()
override;
197 std::string checkPointEventListName,
199 std::string schedulerType,
200 std::string handoverAlgorithmType,
204 std::ostringstream oss;
205 oss <<
"nEnbs=" << nEnbs <<
" nUes=" << nUes <<
" nDedicatedBearers=" << nDedicatedBearers
206 <<
" udp=" << useUdp <<
" " << schedulerType <<
" " << handoverAlgorithmType
207 <<
" admitHo=" << admitHo <<
" hoList: " << checkPointEventListName;
210 oss <<
", ideal RRC";
223 std::list<CheckPointEvent> checkPointEventList,
224 std::string checkPointEventListName,
226 std::string schedulerType,
227 std::string handoverAlgorithmType,
233 checkPointEventListName,
236 handoverAlgorithmType,
241 m_nDedicatedBearers(nDedicatedBearers),
242 m_checkPointEventList(checkPointEventList),
243 m_checkPointEventListName(checkPointEventListName),
246 m_schedulerType(schedulerType),
247 m_handoverAlgorithmType(handoverAlgorithmType),
249 m_useIdealRrc(useIdealRrc),
252 m_udpClientInterval(
Seconds(0.01)),
253 m_udpClientPktSize(100)
285 StringValue(
"ns3::FriisSpectrumPropagationLossModel"));
306 double distance = 1000.0;
316 m_epcHelper = CreateObject<PointToPointEpcHelper>();
325 Vector enbPosition(distance * (i + 1), 0, 0);
326 enbPositionAlloc->Add(enbPosition);
342 Vector(speed, 0, 0));
348 for (
auto it = enbDevices.
Begin(); it != enbDevices.
End(); ++it)
366 remoteHostContainer.
Create(1);
367 remoteHost = remoteHostContainer.
Get(0);
369 internet.Install(remoteHostContainer);
379 ipv4h.
SetBase(
"1.0.0.0",
"255.0.0.0");
382 remoteHostAddr = internetIpIfaces.
GetAddress(1);
387 remoteHostStaticRouting->AddNetworkRouteTo(
Ipv4Address(
"7.0.0.0"),
392 internet.Install(ueNodes);
407 uint16_t dlPort = 10000;
408 uint16_t ulPort = 20000;
414 startTimeSeconds->SetAttribute(
"Min",
DoubleValue(0));
415 startTimeSeconds->SetAttribute(
"Max",
DoubleValue(0.010));
416 startTimeSeconds->SetStream(stream++);
442 clientApps.Add(dlClientHelper.
Install(remoteHost));
444 "ns3::UdpSocketFactory",
448 serverApps.Add(sinkContainer);
453 clientApps.Add(ulClientHelper.
Install(ue));
455 "ns3::UdpSocketFactory",
459 serverApps.Add(sinkContainer);
467 "ns3::TcpSocketFactory",
470 clientApps.Add(dlClientHelper.
Install(remoteHost));
472 "ns3::TcpSocketFactory",
476 serverApps.Add(sinkContainer);
483 clientApps.Add(ulClientHelper.
Install(ue));
485 "ns3::TcpSocketFactory",
489 serverApps.Add(sinkContainer);
514 Time startTime =
Seconds(startTimeSeconds->GetValue());
515 serverApps.Start(startTime);
516 clientApps.Start(startTime);
543 const Time maxRrcConnectionEstablishmentDuration =
Seconds(0.080);
544 for (
auto it = ueDevices.
Begin(); it != ueDevices.
End(); ++it)
561 for (
Time checkPointTime = checkPointEventIt->checkStartTime;
562 checkPointTime < checkPointEventIt->checkStopTime;
563 checkPointTime += checkPointEventIt->checkInterval)
568 ueDevices.
Get(checkPointEventIt->ueDeviceIndex),
569 enbDevices.
Get(checkPointEventIt->enbDeviceIndex));
574 checkPointEventIt->ueDeviceIndex);
580 checkPointEventIt->ueDeviceIndex);
605 uint16_t rnti = ueRrc->GetRnti();
613 uint16_t ueCellId = ueRrc->GetCellId();
614 uint16_t enbCellId = enbLteDevice->GetCellId();
615 uint8_t ueDlBandwidth = ueRrc->GetDlBandwidth();
616 uint8_t enbDlBandwidth = enbLteDevice->GetDlBandwidth();
617 uint8_t ueUlBandwidth = ueRrc->GetUlBandwidth();
618 uint8_t enbUlBandwidth = enbLteDevice->GetUlBandwidth();
619 uint8_t ueDlEarfcn = ueRrc->GetDlEarfcn();
620 uint8_t enbDlEarfcn = enbLteDevice->GetDlEarfcn();
621 uint8_t ueUlEarfcn = ueRrc->GetUlEarfcn();
622 uint8_t enbUlEarfcn = enbLteDevice->GetUlEarfcn();
623 uint64_t ueImsi = ueLteDevice->GetImsi();
624 uint64_t enbImsi = ueManager->GetImsi();
634 ueManager->GetAttribute(
"DataRadioBearerMap", enbDataRadioBearerMapValue);
637 "wrong num bearers at eNB");
640 ueRrc->GetAttribute(
"DataRadioBearerMap", ueDataRadioBearerMapValue);
643 "wrong num bearers at UE");
645 auto enbBearerIt = enbDataRadioBearerMapValue.
Begin();
646 auto ueBearerIt = ueDataRadioBearerMapValue.
Begin();
647 while (enbBearerIt != enbDataRadioBearerMapValue.
End() &&
648 ueBearerIt != ueDataRadioBearerMapValue.
End())
657 (
uint32_t)ueDrbInfo->m_epsBearerIdentity,
658 "epsBearerIdentity differs");
661 "drbIdentity differs");
665 (
uint32_t)ueDrbInfo->m_logicalChannelIdentity,
666 "logicalChannelIdentity differs");
673 NS_ASSERT_MSG(enbBearerIt == enbDataRadioBearerMapValue.
End(),
"too many bearers at eNB");
674 NS_ASSERT_MSG(ueBearerIt == ueDataRadioBearerMapValue.
End(),
"too many bearers at UE");
687 it->dlOldTotalRx = it->dlSink->GetTotalRx();
691 it->ulOldTotalRx = it->ulSink->GetTotalRx();
710 dlRx = it->dlSink->GetTotalRx() - it->dlOldTotalRx;
715 ulRx = it->ulSink->GetTotalRx() - it->ulOldTotalRx;
717 double expectedBytes =
720 NS_LOG_LOGIC(
"expBytes " << expectedBytes <<
" dlRx " << dlRx <<
" ulRx " << ulRx);
726 0.500 * expectedBytes,
727 "too few RX bytes in DL, ue=" << ueIndex <<
", b=" << b);
732 0.500 * expectedBytes,
733 "too few RX bytes in UL, ue=" << ueIndex <<
", b=" << b);
751 :
TestSuite(
"lte-x2-handover-measures", SYSTEM)
755 std::string cel1name(
"ho: 0 -> 1");
756 const std::list<CheckPointEvent> cel1{
761 std::string cel2name(
"ho: 0 -> 1 -> 2");
762 const std::list<CheckPointEvent> cel2{
768 std::string cel3name(
"ho: 0 -> 1 -> 2 -> 3");
769 const std::list<CheckPointEvent> cel3{
776 std::string sched =
"ns3::PfFfMacScheduler";
777 std::string ho =
"ns3::A2A4RsrqHandoverAlgorithm";
778 for (
auto useIdealRrc : {
true,
false})
882 sched =
"ns3::RrFfMacScheduler";
883 for (
auto useIdealRrc : {
true,
false})
921 ho =
"ns3::A3RsrpHandoverAlgorithm";
922 sched =
"ns3::PfFfMacScheduler";
923 for (
auto useIdealRrc : {
true,
false})
961 sched =
"ns3::RrFfMacScheduler";
962 for (
auto useIdealRrc : {
true,
false})
Test different X2 handover measures and algorithms, e.g.
Ptr< PointToPointEpcHelper > m_epcHelper
EPC helper.
std::list< CheckPointEvent > m_checkPointEventList
check point event list
std::string m_schedulerType
scheduler type
std::string m_handoverAlgorithmType
handover algorithm type
bool m_admitHo
whether to configure to admit handover
bool m_useUdp
whether to use UDP traffic
Ptr< LteHelper > m_lteHelper
LTE helper.
const Time m_udpClientInterval
UDP client interval.
void CheckStats(uint32_t ueIndex)
Check stats function.
const Time m_statsDuration
stats duration
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)
Constructor.
bool m_useIdealRrc
whether to use ideal RRC
uint32_t m_nEnbs
number of eNBs in the test
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::string m_checkPointEventListName
check point event list name
bool m_epc
whether to use EPC
void DoRun() override
Implementation to actually run this TestCase.
void SaveStats(uint32_t ueIndex)
Save stats function.
uint32_t m_nDedicatedBearers
number of UEs in the test
uint32_t m_nUes
number of UEs in the test
std::vector< UeData > m_ueDataVector
UE data vector.
const uint32_t m_udpClientPktSize
UDP client packet size.
const Time m_maxHoDuration
maximum HO duration
void CheckConnected(Ptr< NetDevice > ueDevice, Ptr< NetDevice > enbDevice)
Check connected function.
Lte X2 Handover Measures Test Suite.
LteX2HandoverMeasuresTestSuite()
holds a vector of ns3::Application pointers.
Ptr< Application > Get(uint32_t i) const
Get the Ptr<Application> stored in this container at a given index.
AttributeValue implementation for Boolean.
A helper to make it easier to instantiate an ns3::BulkSendApplication on a set of nodes.
void SetAttribute(std::string name, const AttributeValue &value)
Helper function used to set the underlying application attributes, not the socket attributes.
ApplicationContainer Install(NodeContainer c) const
Install an ns3::BulkSendApplication on each node of the input container configured with all the attri...
Mobility model for which the current speed does not change once it has been set and until it is set a...
Class for representing data rates.
AttributeValue implementation for DataRate.
This class can be used to hold variables of floating point type such as 'double' or 'float'.
This class contains the specification of EPS Bearers.
@ NGBR_VIDEO_TCP_DEFAULT
Non-GBR TCP-based Video (Buffered Streaming, e.g., www, e-mail...)
aggregate IP/TCP/UDP functionality to existing Nodes.
A helper class to make life easier while doing simple IPv4 address assignment in scripts.
void SetBase(Ipv4Address network, Ipv4Mask mask, Ipv4Address base="0.0.0.1")
Set the base network number, network mask and base address.
Ipv4InterfaceContainer Assign(const NetDeviceContainer &c)
Assign IP addresses to the net devices specified in the container based on the current network prefix...
Ipv4 addresses are stored in host order in this class.
static Ipv4Address GetAny()
Access to the IPv4 forwarding table, interfaces, and configuration.
holds a vector of std::pair of Ptr<Ipv4> and interface index.
Ipv4Address GetAddress(uint32_t i, uint32_t j=0) const
a class to represent an Ipv4 address mask
Helper class that adds ns3::Ipv4StaticRouting objects.
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...
store information on active data radio bearer instance
The eNodeB device implementation.
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 ...
void SetHandoverAlgorithmAttribute(std::string n, const AttributeValue &v)
Set an attribute for the handover algorithm to be created.
NetDeviceContainer InstallEnbDevice(NodeContainer c)
Create a set of eNodeB devices.
void SetHandoverAlgorithmType(std::string type)
Set the type of handover algorithm to be used by eNodeB devices.
void SetSchedulerType(std::string type)
Set the type of scheduler to be used by eNodeB devices.
void Attach(NetDeviceContainer ueDevices)
Enables automatic attachment of a set of UE devices to a suitable cell using Idle mode initial cell s...
void ActivateDataRadioBearer(NetDeviceContainer ueDevices, EpsBearer bearer)
Activate a Data Radio Bearer on a given UE devices (for LTE-only simulation).
NetDeviceContainer InstallUeDevice(NodeContainer c)
Create a set of UE devices.
void AddX2Interface(NodeContainer enbNodes)
Create an X2 interface between all the eNBs in a given set.
int64_t AssignStreams(NetDeviceContainer c, int64_t stream)
Assign a fixed random variable stream number to the random variables used.
uint8_t ActivateDedicatedEpsBearer(NetDeviceContainer ueDevices, EpsBearer bearer, Ptr< EpcTft > tft)
Activate a dedicated EPS bearer on a given set of UE devices.
The LteUeNetDevice class implements the UE net device.
Helper class used to assign positions and mobility models to nodes.
void Install(Ptr< Node > node) const
"Layout" a single node according to the current position allocator type.
void SetMobilityModel(std::string type, Ts &&... args)
void SetPositionAllocator(Ptr< PositionAllocator > allocator)
Set the position allocator which will be used to allocate the initial position of every node initiali...
Keep track of the current position and velocity of an object.
holds a vector of ns3::NetDevice pointers
uint32_t GetN() const
Get the number of Ptr<NetDevice> stored in this container.
Iterator Begin() const
Get an iterator which refers to the first NetDevice in the container.
Iterator End() const
Get an iterator which indicates past-the-last NetDevice in the container.
Ptr< NetDevice > Get(uint32_t i) const
Get the Ptr<NetDevice> stored in this container at a given index.
Ptr< Node > GetPgwNode() const override
Get the PGW node.
Ipv4Address GetUeDefaultGatewayAddress() override
Ipv4InterfaceContainer AssignUeIpv4Address(NetDeviceContainer ueDevices) override
Assign IPv4 addresses to UE devices.
keep track of a set of node pointers.
uint32_t GetN() const
Get the number of Ptr<Node> stored in this container.
void Create(uint32_t n)
Create n nodes and append pointers to them to the end of this NodeContainer.
Ptr< Node > Get(uint32_t i) const
Get the Ptr<Node> stored in this container at a given index.
void SetAttribute(std::string name, const AttributeValue &value)
Set a single attribute, raising fatal errors if unsuccessful.
Ptr< T > GetObject() const
Get a pointer to the requested aggregated Object.
Container for a set of ns3::Object pointers.
std::size_t GetN() const
Get the number of Objects.
Iterator End() const
Get an iterator to the past-the-end Object.
Iterator Begin() const
Get an iterator to the first Object.
A helper to make it easier to instantiate an ns3::PacketSinkApplication on a set of nodes.
ApplicationContainer Install(NodeContainer c) const
Install an ns3::PacketSinkApplication on each node of the input container configured with all the att...
Receive and consume traffic generated to an IP address and port.
Build a set of PointToPointNetDevice objects.
void SetDeviceAttribute(std::string name, const AttributeValue &value)
Set an attribute value to be propagated to each NetDevice created by the helper.
void SetChannelAttribute(std::string name, const AttributeValue &value)
Set an attribute value to be propagated to each Channel created by the helper.
NetDeviceContainer Install(NodeContainer c)
Smart pointer class similar to boost::intrusive_ptr.
static EventId Schedule(const Time &delay, FUNC f, Ts &&... args)
Schedule an event to expire after delay.
static void Destroy()
Execute the events scheduled with ScheduleDestroy().
static void Run()
Run the simulation.
static void Stop()
Tell the Simulator the calling event should be the last one executed.
Hold variables of type string.
@ EXTENSIVE
Medium length test.
@ TAKES_FOREVER
Very long running test.
void AddTestCase(TestCase *testCase, TestDuration duration=QUICK)
Add an individual child TestCase to this test suite.
Simulation virtual time values and global simulation resolution.
AttributeValue implementation for Time.
Create a client application which sends UDP packets carrying a 32bit sequence number and a 64 bit tim...
ApplicationContainer Install(NodeContainer c)
State
The state of the UeManager at the eNB RRC.
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...
void Reset()
Reset the initial value of every attribute as well as the value of every global to what they were bef...
void SetDefault(std::string name, const AttributeValue &value)
#define NS_FATAL_ERROR(msg)
Report a fatal error with a message and terminate.
#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 ",...
static LteX2HandoverMeasuresTestSuite g_lteX2HandoverMeasuresTestSuiteInstance
Static variable for test initialization.
#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.
#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.
#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.
Time Seconds(double value)
Construct a Time in the indicated unit.
Time MilliSeconds(uint64_t value)
Construct a Time in the indicated unit.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
CheckPointEvent structure.
CheckPointEvent(Time start, Time stop, Time interval, uint32_t ueIndex, uint32_t enbIndex)
Constructor.
Time checkStopTime
check stop time
uint32_t enbDeviceIndex
ENB device index.
Time checkStartTime
check start time
Time checkInterval
check interval
uint32_t ueDeviceIndex
UE device index.
uint32_t ulOldTotalRx
UL old total receive.
uint32_t dlOldTotalRx
DL old total receive.
Ptr< PacketSink > dlSink
DL sink.
Ptr< PacketSink > ulSink
UL sink.
std::list< BearerData > bearerDataList
bearer ID list
Implement the data structure representing a TrafficFlowTemplate Packet Filter.
uint16_t localPortEnd
end of the port number range of the UE
uint16_t remotePortEnd
end of the port number range of the remote host
uint16_t remotePortStart
start of the port number range of the remote host
uint16_t localPortStart
start of the port number range of the UE