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.

	~LteUeMeasurementsHandoverTestCase () override

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.

Public Member Functions inherited from ns3::TestCase
	TestCase (const TestCase &)=delete

virtual	~TestCase ()
	Destructor.

std::string	GetName () const

TestCase &	operator= (const TestCase &)=delete

Private Member Functions
void	DoRun () override
	Setup the simulation with the intended UE measurement reporting configuration, run it, and connect the `RecvMeasurementReportCallback` function to the `LteUeRrc::RecvMeasurementReport` trace source.

void	DoTeardown () override
	Runs at the end of the simulation, verifying that all expected measurement reports have been examined.

Private Attributes
Time	m_duration
	Duration of simulation.

std::vector< uint8_t >	m_expectedRsrp
	The list of expected values of RSRP (in 3GPP range unit) from the measurement reports received.

std::set< uint8_t >	m_expectedSourceCellMeasId
	The list of measurement identities being tested in the source cell.

std::set< uint8_t >	m_expectedTargetCellMeasId
	The list of measurement identities being tested in the target cell.

std::vector< Time >	m_expectedTime
	The list of expected time when measurement reports are received by eNodeB.

std::vector< uint8_t >::iterator	m_itExpectedRsrp
	Pointer to the element of `m_expectedRsrp` which is expected to occur next in the simulation.

std::vector< Time >::iterator	m_itExpectedTime
	Pointer to the element of `m_expectedTime` which is expected to occur next in the simulation.

std::list< LteRrcSap::ReportConfigEutra >	m_sourceConfigList
	The list of active report triggering configuration for the source eNodeB.

std::list< LteRrcSap::ReportConfigEutra >	m_targetConfigList
	The list of active report triggering configuration for the target eNodeB.

Additional Inherited Members
Public Types inherited from ns3::TestCase
enum class	Duration { QUICK = 1 , EXTENSIVE = 2 , TAKES_FOREVER = 3 }
	How long the test takes to execute. More...

Static Public Attributes inherited from ns3::TestCase
static constexpr auto	QUICK = Duration::QUICK
	Deprecated test duration simple enums.

static constexpr auto	EXTENSIVE = Duration::EXTENSIVE

static constexpr auto	TAKES_FOREVER = Duration::TAKES_FOREVER

Protected Member Functions inherited from ns3::TestCase
	TestCase (std::string name)
	Constructor.

void	AddTestCase (TestCase *testCase, Duration duration=Duration::QUICK)
	Add an individual child TestCase to this test suite.

TestCase *	GetParent () const
	Get the parent of this TestCase.

bool	IsStatusFailure () const
	Check if any tests failed.

bool	IsStatusSuccess () const
	Check if all tests passed.

void	SetDataDir (std::string directory)
	Set the data directory where reference trace files can be found.

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.

bool	MustAssertOnFailure () const
	Check if this run should assert on failure.

bool	MustContinueOnFailure () const
	Check if this run should continue on failure.

std::string	CreateDataDirFilename (std::string filename)
	Construct the full path to a file in the data directory.

std::string	CreateTempDirFilename (std::string filename)
	Construct the full path to a file in a temporary directory.

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 548 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

name	the reference name
sourceConfigList	std::list<LteRrcSap::ReportConfigEutra>
targetConfigList	std::list<LteRrcSap::ReportConfigEutra>
expectedTime	the expected time
expectedRsrp	the expected RSRP
duration	the duration

Definition at line 2280 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 ( )

override

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

References NS_LOG_FUNCTION.

Member Function Documentation

◆ DoRun()

void LteUeMeasurementsHandoverTestCase::DoRun ( )

overrideprivatevirtual

Setup the simulation with the intended UE measurement reporting configuration, run it, and connect the RecvMeasurementReportCallback function to the LteUeRrc::RecvMeasurementReport trace source.

Implements ns3::TestCase.

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

References ns3::Ipv4AddressHelper::Assign(), ns3::Config::Connect(), ns3::NodeContainer::Create(), ns3::CreateObject(), ns3::Simulator::Destroy(), ns3::NetDeviceContainer::Get(), ns3::NodeContainer::Get(), ns3::Time::GetMilliSeconds(), ns3::NodeContainer::GetN(), ns3::TestCase::GetName(), ns3::Ipv4StaticRoutingHelper::GetStaticRouting(), ns3::PointToPointHelper::Install(), m_duration, m_expectedSourceCellMeasId, m_expectedTargetCellMeasId, m_sourceConfigList, m_targetConfigList, ns3::MakeCallback(), ns3::MilliSeconds(), NS_LOG_INFO, RecvMeasurementReportCallback(), ns3::Simulator::Run(), ns3::Seconds(), ns3::Ipv4AddressHelper::SetBase(), ns3::PointToPointHelper::SetChannelAttribute(), ns3::Config::SetDefault(), ns3::PointToPointHelper::SetDeviceAttribute(), and ns3::Simulator::Stop().

Here is the call graph for this function:

◆ DoTeardown()

void LteUeMeasurementsHandoverTestCase::DoTeardown ( )

overrideprivatevirtual

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

Reimplemented from ns3::TestCase.

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

References m_expectedRsrp, m_expectedTime, m_itExpectedRsrp, m_itExpectedTime, NS_ASSERT, NS_LOG_FUNCTION, NS_TEST_ASSERT_MSG_EQ, and ns3::Time::S.

◆ RecvMeasurementReportCallback()

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