A Discrete-Event Network Simulator
API
LteUeMeasurementsHandoverTestCase Class Reference

Testing UE measurements in LTE with simulation of 2 eNodeB and 1 UE in a handover configuration. More...

#include "lte-test-ue-measurements.h"

+ Inheritance diagram for LteUeMeasurementsHandoverTestCase:
+ Collaboration diagram for LteUeMeasurementsHandoverTestCase:

Public Member Functions

 LteUeMeasurementsHandoverTestCase (std::string name, std::list< LteRrcSap::ReportConfigEutra > sourceConfigList, std::list< LteRrcSap::ReportConfigEutra > targetConfigList, std::vector< Time > expectedTime, std::vector< uint8_t > expectedRsrp, Time duration)
 Constructor. More...
 
virtual ~LteUeMeasurementsHandoverTestCase ()
 
void RecvMeasurementReportCallback (std::string context, uint64_t imsi, uint16_t cellId, uint16_t rnti, LteRrcSap::MeasurementReport report)
 Triggers when either one of the eNodeBs receives measurement report from UE, then perform verification on it. More...
 
- 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

virtual void DoRun ()
 Setup the simulation with the intended UE measurement reporting configuration, run it, and connect the RecvMeasurementReportCallback function to the LteUeRrc::RecvMeasurementReport trace source. More...
 
virtual void DoTeardown ()
 Runs at the end of the simulation, verifying that all expected measurement reports have been examined. More...
 

Private Attributes

Time m_duration
 Duration of simulation. More...
 
std::vector< uint8_t > m_expectedRsrp
 The list of expected values of RSRP (in 3GPP range unit) from the measurement reports received. More...
 
std::set< uint8_t > m_expectedSourceCellMeasId
 The list of measurement identities being tested in the source cell. More...
 
std::set< uint8_t > m_expectedTargetCellMeasId
 The list of measurement identities being tested in the target cell. More...
 
std::vector< Timem_expectedTime
 The list of expected time when measurement reports are received by eNodeB. More...
 
std::vector< uint8_t >::iterator m_itExpectedRsrp
 Pointer to the element of m_expectedRsrp which is expected to occur next in the simulation. More...
 
std::vector< Time >::iterator m_itExpectedTime
 Pointer to the element of m_expectedTime which is expected to occur next in the simulation. More...
 
std::list< LteRrcSap::ReportConfigEutram_sourceConfigList
 The list of active report triggering configuration for the source eNodeB. More...
 
std::list< LteRrcSap::ReportConfigEutram_targetConfigList
 The list of active report triggering configuration for the target eNodeB. 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

Testing UE measurements in LTE with simulation of 2 eNodeB and 1 UE in a handover configuration.

The simulation will run for the specified duration, while the handover command will be issued exactly at the middle of simulation. Handover test covers four different scenarios: switch from event A1 to event A2, from event A2 to event A1, from event A3 to event A4, from event A4 to event A3, from event A2 to event A3, from event A3 to event A2, from event A4 to event A5, from event A5 to event A4. Additionally, it tests different handover threshold configurations, A2 threshold difference, A3 offset difference, A4 and A5 threshold difference. Finally, different handover is tested for different time-to-trigger (TTT) configurations.

Definition at line 569 of file lte-test-ue-measurements.h.

Constructor & Destructor Documentation

◆ LteUeMeasurementsHandoverTestCase()

LteUeMeasurementsHandoverTestCase::LteUeMeasurementsHandoverTestCase ( std::string  name,
std::list< LteRrcSap::ReportConfigEutra sourceConfigList,
std::list< LteRrcSap::ReportConfigEutra targetConfigList,
std::vector< Time expectedTime,
std::vector< uint8_t >  expectedRsrp,
Time  duration 
)

Constructor.

Parameters
namethe reference name
sourceConfigListstd::list<LteRrcSap::ReportConfigEutra>
targetConfigListstd::list<LteRrcSap::ReportConfigEutra>
expectedTimethe expected time
expectedRsrpthe expected RSRP
durationthe duration

Definition at line 1897 of file lte-test-ue-measurements.cc.

References m_expectedRsrp, m_expectedTime, m_itExpectedRsrp, m_itExpectedTime, NS_FATAL_ERROR, and NS_LOG_INFO.

◆ ~LteUeMeasurementsHandoverTestCase()

LteUeMeasurementsHandoverTestCase::~LteUeMeasurementsHandoverTestCase ( )
virtual

Definition at line 1924 of file lte-test-ue-measurements.cc.

References NS_LOG_FUNCTION.

Member Function Documentation

◆ DoRun()

void LteUeMeasurementsHandoverTestCase::DoRun ( void  )
privatevirtual

◆ DoTeardown()

void LteUeMeasurementsHandoverTestCase::DoTeardown ( void  )
privatevirtual

Runs at the end of the simulation, verifying that all expected measurement reports have been examined.

Reimplemented from ns3::TestCase.

Definition at line 2071 of file lte-test-ue-measurements.cc.

References m_expectedRsrp, m_expectedTime, m_itExpectedRsrp, m_itExpectedTime, NS_ASSERT, NS_LOG_FUNCTION, and NS_TEST_ASSERT_MSG_EQ.

◆ RecvMeasurementReportCallback()

void LteUeMeasurementsHandoverTestCase::RecvMeasurementReportCallback ( std::string  context,
uint64_t  imsi,
uint16_t  cellId,
uint16_t  rnti,
LteRrcSap::MeasurementReport  report 
)

Triggers when either one of the eNodeBs receives measurement report from UE, then perform verification on it.

The trigger is set up beforehand by connecting to the LteUeRrc::RecvMeasurementReport trace source.

Verification consists of checking whether the report carries the right value of RSRP or not, and whether it occurs at the expected time or not.

Parameters
contextthe context
imsithe IMSI
cellIdthe cell ID
rntithe RNTI
reportLteRrcSap::MeasurementReport

Definition at line 2082 of file lte-test-ue-measurements.cc.

References ns3::Time::GetMilliSeconds(), ns3::LteRrcSap::MeasResults::haveMeasResultNeighCells, m_expectedRsrp, m_expectedSourceCellMeasId, m_expectedTargetCellMeasId, m_expectedTime, m_itExpectedRsrp, m_itExpectedTime, ns3::LteRrcSap::MeasResults::measId, ns3::LteRrcSap::MeasResults::measResultListEutra, ns3::LteRrcSap::MeasResults::measResultPCell, ns3::LteRrcSap::MeasurementReport::measResults, ns3::Now(), NS_ASSERT, NS_FATAL_ERROR, NS_LOG_DEBUG, NS_LOG_FUNCTION, NS_TEST_ASSERT_MSG_EQ, ns3::LteRrcSap::MeasResultPCell::rsrpResult, and ns3::LteRrcSap::MeasResultPCell::rsrqResult.

Referenced by DoRun().

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

Member Data Documentation

◆ m_duration

Time LteUeMeasurementsHandoverTestCase::m_duration
private

Duration of simulation.

Definition at line 665 of file lte-test-ue-measurements.h.

Referenced by DoRun().

◆ m_expectedRsrp

std::vector<uint8_t> LteUeMeasurementsHandoverTestCase::m_expectedRsrp
private

The list of expected values of RSRP (in 3GPP range unit) from the measurement reports received.

Definition at line 648 of file lte-test-ue-measurements.h.

Referenced by LteUeMeasurementsHandoverTestCase(), DoTeardown(), and RecvMeasurementReportCallback().

◆ m_expectedSourceCellMeasId

std::set<uint8_t> LteUeMeasurementsHandoverTestCase::m_expectedSourceCellMeasId
private

The list of measurement identities being tested in the source cell.

Measurement reports with different measurement identity (e.g. from handover algorithm and ANR) will be ignored.

Definition at line 672 of file lte-test-ue-measurements.h.

Referenced by DoRun(), and RecvMeasurementReportCallback().

◆ m_expectedTargetCellMeasId

std::set<uint8_t> LteUeMeasurementsHandoverTestCase::m_expectedTargetCellMeasId
private

The list of measurement identities being tested in the target cell.

Measurement reports with different measurement identity (e.g. from handover algorithm and ANR) will be ignored.

Definition at line 679 of file lte-test-ue-measurements.h.

Referenced by DoRun(), and RecvMeasurementReportCallback().

◆ m_expectedTime

std::vector<Time> LteUeMeasurementsHandoverTestCase::m_expectedTime
private

The list of expected time when measurement reports are received by eNodeB.

Definition at line 642 of file lte-test-ue-measurements.h.

Referenced by LteUeMeasurementsHandoverTestCase(), DoTeardown(), and RecvMeasurementReportCallback().

◆ m_itExpectedRsrp

std::vector<uint8_t>::iterator LteUeMeasurementsHandoverTestCase::m_itExpectedRsrp
private

Pointer to the element of m_expectedRsrp which is expected to occur next in the simulation.

Definition at line 660 of file lte-test-ue-measurements.h.

Referenced by LteUeMeasurementsHandoverTestCase(), DoTeardown(), and RecvMeasurementReportCallback().

◆ m_itExpectedTime

std::vector<Time>::iterator LteUeMeasurementsHandoverTestCase::m_itExpectedTime
private

Pointer to the element of m_expectedTime which is expected to occur next in the simulation.

Definition at line 654 of file lte-test-ue-measurements.h.

Referenced by LteUeMeasurementsHandoverTestCase(), DoTeardown(), and RecvMeasurementReportCallback().

◆ m_sourceConfigList

std::list<LteRrcSap::ReportConfigEutra> LteUeMeasurementsHandoverTestCase::m_sourceConfigList
private

The list of active report triggering configuration for the source eNodeB.

Definition at line 630 of file lte-test-ue-measurements.h.

Referenced by DoRun().

◆ m_targetConfigList

std::list<LteRrcSap::ReportConfigEutra> LteUeMeasurementsHandoverTestCase::m_targetConfigList
private

The list of active report triggering configuration for the target eNodeB.

Definition at line 636 of file lte-test-ue-measurements.h.

Referenced by DoRun().


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