Testing UE measurements in LTE with simulation of 2 eNodeB and 1 UE in piecewise configuration and 240 ms report interval. More...

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

Inheritance diagram for LteUeMeasurementsPiecewiseTestCase2:

Public Member Functions
	LteUeMeasurementsPiecewiseTestCase2 (std::string name, LteRrcSap::ReportConfigEutra config, std::vector< Time > expectedTime, std::vector< uint8_t > expectedRsrp)
	Constructor. More...

virtual	~LteUeMeasurementsPiecewiseTestCase2 ()

void	RecvMeasurementReportCallback (std::string context, uint64_t imsi, uint16_t cellId, uint16_t rnti, LteRrcSap::MeasurementReport report)
	Triggers when eNodeB receives measurement report from UE, then perform verification on it. More...

Public Member Functions inherited from ns3::TestCase
virtual	~TestCase ()
	Destructor. More...

std::string	GetName (void) const

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

void	TeleportFar ()
	Teleport far function. More...

void	TeleportNear ()
	Teleport near function. More...

void	TeleportVeryFar ()
	Teleport very far function. More...

void	TeleportVeryNear ()
	Teleport very near function. More...

Private Attributes
LteRrcSap::ReportConfigEutra	m_config
	The active report triggering configuration. More...

uint8_t	m_expectedMeasId
	The measurement identity being tested. 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::vector< Time >	m_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...

Ptr< MobilityModel >	m_ueMobility
	the mobility model 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...

TestCase *	GetParent () 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 piecewise configuration and 240 ms report interval.

Here is intenisvely test events A1 and A2. A1 event should be triggered when the serving cell becomes better than a given threshold. A2 shall be triggered when the serving cell becomes worse than threshold. A3 event is triggered when the neighbour becomes offset better than the PCell. In this test UE is being transported several times during the simulation duration. Then the test checks if measurement report contains correct RSRP and RSRQ result, than if CQI info is correctly generated, if the reporting occurs at the correct time stamp in the simulation and according to the measurements configuration. It also checks if the reported values of RSRP and RSRQ are equal to expected reference values.

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

Constructor & Destructor Documentation

◆ LteUeMeasurementsPiecewiseTestCase2()

LteUeMeasurementsPiecewiseTestCase2::LteUeMeasurementsPiecewiseTestCase2	(	std::string	name,
		LteRrcSap::ReportConfigEutra	config,
		std::vector< Time >	expectedTime,
		std::vector< uint8_t >	expectedRsrp
	)

Constructor.

Parameters

name	the reference name
config	LteRrcSap::ReportConfigEutra
expectedTime	the expected time
expectedRsrp	the expected RSRP

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

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

◆ ~LteUeMeasurementsPiecewiseTestCase2()

LteUeMeasurementsPiecewiseTestCase2::~LteUeMeasurementsPiecewiseTestCase2 ( )

virtual

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

References NS_LOG_FUNCTION.

Member Function Documentation

◆ DoRun()

void LteUeMeasurementsPiecewiseTestCase2::DoRun ( void )

privatevirtual

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 1133 of file lte-test-ue-measurements.cc.

References ns3::LteHelper::ActivateDataRadioBearer(), ns3::ListPositionAllocator::Add(), ns3::LteEnbRrc::AddUeMeasReportConfig(), ns3::LteHelper::Attach(), ns3::Config::Connect(), ns3::NodeContainer::Create(), ns3::NetDeviceContainer::Get(), ns3::NodeContainer::Get(), ns3::TestCase::GetName(), ns3::Object::GetObject(), ns3::LteHelper::InstallEnbDevice(), ns3::LteHelper::InstallUeDevice(), m_config, m_expectedMeasId, m_ueMobility, ns3::MakeCallback(), ns3::MilliSeconds(), third::mobility, NS_LOG_INFO, RecvMeasurementReportCallback(), ns3::Seconds(), ns3::ObjectBase::SetAttribute(), ns3::Config::SetDefault(), ns3::LteHelper::SetSchedulerAttribute(), ns3::LteHelper::SetSchedulerType(), TeleportFar(), TeleportNear(), TeleportVeryFar(), and TeleportVeryNear().

◆ DoTeardown()

void LteUeMeasurementsPiecewiseTestCase2::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 1245 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 LteUeMeasurementsPiecewiseTestCase2::RecvMeasurementReportCallback	(	std::string	context,
		uint64_t	imsi,
		uint16_t	cellId,
		uint16_t	rnti,
		LteRrcSap::MeasurementReport	report
	)