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

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

Inheritance diagram for LteUeMeasurementsPiecewiseTestCase1:

Collaboration diagram for LteUeMeasurementsPiecewiseTestCase1:

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

	~LteUeMeasurementsPiecewiseTestCase1 () override

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
	TestCase (const TestCase &)=delete

virtual	~TestCase ()
	Destructor. More...

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

void	DoTeardown () override
	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 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 TestCase. More...

bool	IsStatusFailure () const
	Check if any tests failed. More...

bool	IsStatusSuccess () 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 () const
	Check if this run should assert on failure. More...

bool	MustContinueOnFailure () 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 1 eNodeB and 1 UE in piecewise configuration and 120 ms report interval.

During the simulation the placement of UE is being changed several times. Four different cases are considered: UE is very near to eNodeB, UE is near to eNodeB, UE is far from eNodeB and UE is very far from eNodeB. Test checks if the measurements correspond to the real conditions of the UE, i.e. when the signal from serving cell becomes weak, the measurements should also start to correspond to the new channel conditions. Additionally, it is checked if UE detects some neighboring signal, if it does the test fails because there is no neighbor in this configuration. Also, test checks if the reporting occurs at intervals that it should according to the measurements configuration. If it occurs in some different time stamp the test will fail.

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

Constructor & Destructor Documentation

◆ LteUeMeasurementsPiecewiseTestCase1()

LteUeMeasurementsPiecewiseTestCase1::LteUeMeasurementsPiecewiseTestCase1	(	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 710 of file lte-test-ue-measurements.cc.

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

◆ ~LteUeMeasurementsPiecewiseTestCase1()

LteUeMeasurementsPiecewiseTestCase1::~LteUeMeasurementsPiecewiseTestCase1 ( )

override

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

References NS_LOG_FUNCTION.

Member Function Documentation

◆ DoRun()

void LteUeMeasurementsPiecewiseTestCase1::DoRun ( void )

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

References ns3::LteHelper::ActivateDataRadioBearer(), 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().

Here is the call graph for this function:

◆ DoTeardown()

void LteUeMeasurementsPiecewiseTestCase1::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 854 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 LteUeMeasurementsPiecewiseTestCase1::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.

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

context	the context
imsi	the IMSI
cellId	the cell ID
rnti	the RNTI
report	LteRrcSap::MeasurementReport

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

References ns3::Time::GetMilliSeconds(), ns3::LteRrcSap::MeasResults::haveMeasResultNeighCells, m_expectedMeasId, m_expectedRsrp, 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_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:

◆ TeleportFar()

void LteUeMeasurementsPiecewiseTestCase1::TeleportFar ( )

private

Teleport far function.

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

References m_ueMobility, NS_LOG_FUNCTION, and ns3::MobilityModel::SetPosition().

Referenced by DoRun().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ TeleportNear()

void LteUeMeasurementsPiecewiseTestCase1::TeleportNear ( )

private

Teleport near function.

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

References m_ueMobility, NS_LOG_FUNCTION, and ns3::MobilityModel::SetPosition().

Referenced by DoRun().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ TeleportVeryFar()

void LteUeMeasurementsPiecewiseTestCase1::TeleportVeryFar ( )

private

Teleport far function.

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

References m_ueMobility, NS_LOG_FUNCTION, and ns3::MobilityModel::SetPosition().

Referenced by DoRun().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ TeleportVeryNear()

void LteUeMeasurementsPiecewiseTestCase1::TeleportVeryNear ( )

private

Teleport very near function.

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

References m_ueMobility, NS_LOG_FUNCTION, 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_config

LteRrcSap::ReportConfigEutra LteUeMeasurementsPiecewiseTestCase1::m_config

private

The active report triggering configuration.

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

Referenced by DoRun().

◆ m_expectedMeasId

uint8_t LteUeMeasurementsPiecewiseTestCase1::m_expectedMeasId

private

The measurement identity being tested.

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

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

Referenced by DoRun(), and RecvMeasurementReportCallback().

◆ m_expectedRsrp

std::vector<uint8_t> LteUeMeasurementsPiecewiseTestCase1::m_expectedRsrp

private

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

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

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

◆ m_expectedTime

std::vector<Time> LteUeMeasurementsPiecewiseTestCase1::m_expectedTime

private

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

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

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

◆ m_itExpectedRsrp

std::vector<uint8_t>::iterator LteUeMeasurementsPiecewiseTestCase1::m_itExpectedRsrp

private

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

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

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

◆ m_itExpectedTime

std::vector<Time>::iterator LteUeMeasurementsPiecewiseTestCase1::m_itExpectedTime

private

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

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

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

◆ m_ueMobility

Ptr<MobilityModel> LteUeMeasurementsPiecewiseTestCase1::m_ueMobility

private

the mobility model

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

Referenced by DoRun(), TeleportFar(), TeleportNear(), TeleportVeryFar(), and TeleportVeryNear().

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

src/lte/test/lte-test-ue-measurements.h
src/lte/test/lte-test-ue-measurements.cc

Public Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ LteUeMeasurementsPiecewiseTestCase1()

◆ ~LteUeMeasurementsPiecewiseTestCase1()

Member Function Documentation

◆ DoRun()

◆ DoTeardown()

◆ RecvMeasurementReportCallback()

◆ TeleportFar()

◆ TeleportNear()

◆ TeleportVeryFar()

◆ TeleportVeryNear()

Member Data Documentation

◆ m_config

◆ m_expectedMeasId

◆ m_expectedRsrp

◆ m_expectedTime

◆ m_itExpectedRsrp

◆ m_itExpectedTime

◆ m_ueMobility