A Discrete-Event Network Simulator
API
LteX2HandoverTestCase Class Reference

Test X2 Handover. More...

+ Inheritance diagram for LteX2HandoverTestCase:
+ Collaboration diagram for LteX2HandoverTestCase:

Classes

struct  BearerData
 BearerData structure. More...
 
struct  UeData
 UeData structure. More...
 

Public Member Functions

 LteX2HandoverTestCase (uint32_t nUes, uint32_t nDedicatedBearers, std::list< HandoverEvent > handoverEventList, std::string handoverEventListName, std::string schedulerType, bool admitHo, bool useIdealRrc)
 
- Public Member Functions inherited from ns3::TestCase
 TestCase (const TestCase &)=delete
 
virtual ~TestCase ()
 Destructor. More...
 
std::string GetName (void) const
 
TestCaseoperator= (const TestCase &)=delete
 

Private Member Functions

void CheckConnected (Ptr< NetDevice > ueDevice, Ptr< NetDevice > enbDevice)
 Check connected function. More...
 
void CheckStatsAWhileAfterHandover (uint32_t ueIndex)
 Check stats a while after handover function. More...
 
virtual void DoRun (void)
 Implementation to actually run this TestCase. More...
 
void SaveStatsAfterHandover (uint32_t ueIndex)
 Save stats after handover function. More...
 
void TeleportUeNearTargetEnb (Ptr< Node > ueNode, Ptr< Node > enbNode)
 Teleport UE near the target eNB of the handover. More...
 
void TeleportUeToMiddle (Ptr< Node > ueNode)
 Teleport UE between both eNBs of the test. More...
 

Static Private Member Functions

static std::string BuildNameString (uint32_t nUes, uint32_t nDedicatedBearers, std::string handoverEventListName, std::string schedulerType, bool admitHo, bool useIdealRrc)
 Build name string. More...
 

Private Attributes

bool m_admitHo
 whether to admit the handover request More...
 
bool m_epc
 whether to use EPC More...
 
Ptr< PointToPointEpcHelperm_epcHelper
 EPC helper. More...
 
std::list< HandoverEventm_handoverEventList
 handover event list More...
 
std::string m_handoverEventListName
 handover event list name More...
 
Ptr< LteHelperm_lteHelper
 LTE helper. More...
 
const Time m_maxHoDuration
 maximum HO duration More...
 
uint32_t m_nDedicatedBearers
 number of UEs in the test More...
 
uint32_t m_nUes
 number of UEs in the test More...
 
std::string m_schedulerType
 scheduler type More...
 
const Time m_statsDuration
 stats duration More...
 
const Time m_udpClientInterval
 UDP client interval. More...
 
const uint32_t m_udpClientPktSize
 UDP client packet size. More...
 
std::vector< UeDatam_ueDataVector
 UE data vector. More...
 
bool m_useIdealRrc
 whether to use the ideal RRC More...
 

Additional Inherited Members

- Public Types inherited from ns3::TestCase
enum  TestDuration { QUICK = 1 , EXTENSIVE = 2 , TAKES_FOREVER = 3 }
 How long the test takes to execute. More...
 
- Protected Member Functions inherited from ns3::TestCase
 TestCase (std::string name)
 Constructor. More...
 
void AddTestCase (TestCase *testCase, TestDuration duration=QUICK)
 Add an individual child TestCase to this test suite. More...
 
TestCaseGetParent () const
 Get the parent of this TestCsse. More...
 
bool IsStatusFailure (void) const
 Check if any tests failed. More...
 
bool IsStatusSuccess (void) const
 Check if all tests passed. More...
 
void SetDataDir (std::string directory)
 Set the data directory where reference trace files can be found. More...
 
void ReportTestFailure (std::string cond, std::string actual, std::string limit, std::string message, std::string file, int32_t line)
 Log the failure of this TestCase. More...
 
bool MustAssertOnFailure (void) const
 Check if this run should assert on failure. More...
 
bool MustContinueOnFailure (void) const
 Check if this run should continue on failure. More...
 
std::string CreateDataDirFilename (std::string filename)
 Construct the full path to a file in the data directory. More...
 
std::string CreateTempDirFilename (std::string filename)
 Construct the full path to a file in a temporary directory. More...
 

Detailed Description

Test X2 Handover.

In this test is used NoOpHandoverAlgorithm and the request for handover is generated manually, and it is not based on measurements.

Definition at line 56 of file test-lte-x2-handover.cc.

Constructor & Destructor Documentation

◆ LteX2HandoverTestCase()

LteX2HandoverTestCase::LteX2HandoverTestCase ( uint32_t  nUes,
uint32_t  nDedicatedBearers,
std::list< HandoverEvent handoverEventList,
std::string  handoverEventListName,
std::string  schedulerType,
bool  admitHo,
bool  useIdealRrc 
)
Parameters
nUesnumber of UEs in the test
nDedicatedBearersnumber of bearers to be activated per UE
handoverEventList
handoverEventListName
schedulerTypethe scheduler type
admitHo
useIdealRrctrue if the ideal RRC should be used

Definition at line 183 of file test-lte-x2-handover.cc.

Member Function Documentation

◆ BuildNameString()

std::string LteX2HandoverTestCase::BuildNameString ( uint32_t  nUes,
uint32_t  nDedicatedBearers,
std::string  handoverEventListName,
std::string  schedulerType,
bool  admitHo,
bool  useIdealRrc 
)
staticprivate

Build name string.

Parameters
nUesnumber of UEs in the test
nDedicatedBearersnumber of bearers to be activated per UE
handoverEventListName
schedulerTypethe scheduler type
admitHo
useIdealRrctrue if the ideal RRC should be used
Returns
the name string

Definition at line 164 of file test-lte-x2-handover.cc.

Referenced by DoRun().

+ Here is the caller graph for this function:

◆ CheckConnected()

void LteX2HandoverTestCase::CheckConnected ( Ptr< NetDevice ueDevice,
Ptr< NetDevice enbDevice 
)
private

◆ CheckStatsAWhileAfterHandover()

void LteX2HandoverTestCase::CheckStatsAWhileAfterHandover ( uint32_t  ueIndex)
private

Check stats a while after handover function.

Parameters
ueIndexthe index of the UE

Definition at line 578 of file test-lte-x2-handover.cc.

References m_statsDuration, m_udpClientInterval, m_udpClientPktSize, m_ueDataVector, and NS_TEST_ASSERT_MSG_EQ.

Referenced by DoRun().

+ Here is the caller graph for this function:

◆ DoRun()

void LteX2HandoverTestCase::DoRun ( void  )
privatevirtual

Implementation to actually run this TestCase.

Subclasses should override this method to conduct their tests.

Implements ns3::TestCase.

Definition at line 201 of file test-lte-x2-handover.cc.

References ns3::LteHelper::ActivateDataRadioBearer(), ns3::LteHelper::ActivateDedicatedEpsBearer(), ns3::LteHelper::AddX2Interface(), ns3::Ipv4AddressHelper::Assign(), ns3::LteHelper::AssignStreams(), ns3::NoBackhaulEpcHelper::AssignUeIpv4Address(), ns3::LteHelper::Attach(), LteX2HandoverTestCase::UeData::bearerDataList, ns3::NetDeviceContainer::Begin(), BuildNameString(), CheckConnected(), CheckStatsAWhileAfterHandover(), first::clientApps, ns3::NodeContainer::Create(), LteX2HandoverTestCase::BearerData::dlSink, ns3::NetDeviceContainer::End(), ns3::ApplicationContainer::Get(), ns3::NetDeviceContainer::Get(), ns3::NodeContainer::Get(), ns3::Ipv4InterfaceContainer::GetAddress(), ns3::NetDeviceContainer::GetN(), ns3::NodeContainer::GetN(), ns3::Object::GetObject(), ns3::NoBackhaulEpcHelper::GetPgwNode(), ns3::Ipv4StaticRoutingHelper::GetStaticRouting(), ns3::NoBackhaulEpcHelper::GetUeDefaultGatewayAddress(), ns3::UniformRandomVariable::GetValue(), ns3::LteHelper::HandoverRequest(), ns3::UdpClientHelper::Install(), ns3::PointToPointHelper::Install(), ns3::PacketSinkHelper::Install(), ns3::InternetStackHelper::Install(), ns3::LteHelper::InstallEnbDevice(), ns3::LteHelper::InstallUeDevice(), ns3::EpcTft::PacketFilter::localPortEnd, ns3::EpcTft::PacketFilter::localPortStart, m_admitHo, m_epc, m_epcHelper, m_handoverEventList, m_handoverEventListName, m_lteHelper, m_maxHoDuration, m_nDedicatedBearers, m_nUes, m_schedulerType, m_statsDuration, m_udpClientInterval, m_udpClientPktSize, m_ueDataVector, m_useIdealRrc, ns3::MilliSeconds(), third::mobility, NS_LOG_FUNCTION, ns3::EpcTft::PacketFilter::remotePortEnd, ns3::EpcTft::PacketFilter::remotePortStart, ns3::Config::Reset(), SaveStatsAfterHandover(), ns3::Seconds(), first::serverApps, ns3::ObjectBase::SetAttribute(), ns3::Ipv4AddressHelper::SetBase(), ns3::PointToPointHelper::SetChannelAttribute(), ns3::Config::SetDefault(), ns3::PointToPointHelper::SetDeviceAttribute(), ns3::LteHelper::SetEpcHelper(), ns3::LteHelper::SetHandoverAlgorithmType(), ns3::LteHelper::SetSchedulerType(), ns3::RandomVariableStream::SetStream(), startTime, stopTime, TeleportUeNearTargetEnb(), TeleportUeToMiddle(), and LteX2HandoverTestCase::BearerData::ulSink.

+ Here is the call graph for this function:

◆ SaveStatsAfterHandover()

void LteX2HandoverTestCase::SaveStatsAfterHandover ( uint32_t  ueIndex)
private

Save stats after handover function.

Parameters
ueIndexthe index of the UE

Definition at line 566 of file test-lte-x2-handover.cc.

References m_ueDataVector.

Referenced by DoRun().

+ Here is the caller graph for this function:

◆ TeleportUeNearTargetEnb()

void LteX2HandoverTestCase::TeleportUeNearTargetEnb ( Ptr< Node ueNode,
Ptr< Node enbNode 
)
private

Teleport UE near the target eNB of the handover.

Parameters
ueNodethe UE node
enbNodethe target eNB node

Definition at line 556 of file test-lte-x2-handover.cc.

References ns3::Object::GetObject(), ns3::MobilityModel::GetPosition(), and ns3::MobilityModel::SetPosition().

Referenced by DoRun().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ TeleportUeToMiddle()

void LteX2HandoverTestCase::TeleportUeToMiddle ( Ptr< Node ueNode)
private

Teleport UE between both eNBs of the test.

Parameters
ueNodethe UE node

Definition at line 549 of file test-lte-x2-handover.cc.

References ns3::Object::GetObject(), and ns3::MobilityModel::SetPosition().

Referenced by DoRun().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

Member Data Documentation

◆ m_admitHo

bool LteX2HandoverTestCase::m_admitHo
private

whether to admit the handover request

Definition at line 111 of file test-lte-x2-handover.cc.

Referenced by DoRun().

◆ m_epc

bool LteX2HandoverTestCase::m_epc
private

whether to use EPC

Definition at line 109 of file test-lte-x2-handover.cc.

Referenced by DoRun().

◆ m_epcHelper

Ptr<PointToPointEpcHelper> LteX2HandoverTestCase::m_epcHelper
private

EPC helper.

Definition at line 114 of file test-lte-x2-handover.cc.

Referenced by DoRun().

◆ m_handoverEventList

std::list<HandoverEvent> LteX2HandoverTestCase::m_handoverEventList
private

handover event list

Definition at line 107 of file test-lte-x2-handover.cc.

Referenced by DoRun().

◆ m_handoverEventListName

std::string LteX2HandoverTestCase::m_handoverEventListName
private

handover event list name

Definition at line 108 of file test-lte-x2-handover.cc.

Referenced by DoRun().

◆ m_lteHelper

Ptr<LteHelper> LteX2HandoverTestCase::m_lteHelper
private

LTE helper.

Definition at line 113 of file test-lte-x2-handover.cc.

Referenced by DoRun().

◆ m_maxHoDuration

const Time LteX2HandoverTestCase::m_maxHoDuration
private

maximum HO duration

Definition at line 156 of file test-lte-x2-handover.cc.

Referenced by DoRun().

◆ m_nDedicatedBearers

uint32_t LteX2HandoverTestCase::m_nDedicatedBearers
private

number of UEs in the test

Definition at line 106 of file test-lte-x2-handover.cc.

Referenced by CheckConnected(), and DoRun().

◆ m_nUes

uint32_t LteX2HandoverTestCase::m_nUes
private

number of UEs in the test

Definition at line 105 of file test-lte-x2-handover.cc.

Referenced by DoRun().

◆ m_schedulerType

std::string LteX2HandoverTestCase::m_schedulerType
private

scheduler type

Definition at line 110 of file test-lte-x2-handover.cc.

Referenced by DoRun().

◆ m_statsDuration

const Time LteX2HandoverTestCase::m_statsDuration
private

stats duration

Definition at line 157 of file test-lte-x2-handover.cc.

Referenced by CheckStatsAWhileAfterHandover(), and DoRun().

◆ m_udpClientInterval

const Time LteX2HandoverTestCase::m_udpClientInterval
private

UDP client interval.

Definition at line 158 of file test-lte-x2-handover.cc.

Referenced by CheckStatsAWhileAfterHandover(), and DoRun().

◆ m_udpClientPktSize

const uint32_t LteX2HandoverTestCase::m_udpClientPktSize
private

UDP client packet size.

Definition at line 159 of file test-lte-x2-handover.cc.

Referenced by CheckStatsAWhileAfterHandover(), and DoRun().

◆ m_ueDataVector

std::vector<UeData> LteX2HandoverTestCase::m_ueDataVector
private

UE data vector.

Definition at line 154 of file test-lte-x2-handover.cc.

Referenced by CheckStatsAWhileAfterHandover(), DoRun(), and SaveStatsAfterHandover().

◆ m_useIdealRrc

bool LteX2HandoverTestCase::m_useIdealRrc
private

whether to use the ideal RRC

Definition at line 112 of file test-lte-x2-handover.cc.

Referenced by DoRun().


The documentation for this class was generated from the following file: