Testing UE measurements in LTE with simulation of 3 eNodeB and 1 UE in piecewise configuration and 240 ms report interval. More...
#include "lte-test-ue-measurements.h"
Public Member Functions | |
LteUeMeasurementsPiecewiseTestCase3 (std::string name, LteRrcSap::ReportConfigEutra config, std::vector< Time > expectedTime) | |
Constructor. More... | |
~LteUeMeasurementsPiecewiseTestCase3 () 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 | TeleportEnbNear () |
Teleport the eNb near function. More... | |
Private Attributes | |
LteRrcSap::ReportConfigEutra | m_config |
The active report triggering configuration. More... | |
Ptr< MobilityModel > | m_enbMobility |
the mobility model More... | |
uint8_t | m_expectedMeasId |
The measurement identity being tested. More... | |
std::vector< Time > | m_expectedTime |
The list of expected time when measurement reports are received by eNodeB. More... | |
std::vector< Time >::iterator | m_itExpectedTime |
Pointer to the element of m_expectedTime which is expected to occur next in the simulation. 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... | |
Testing UE measurements in LTE with simulation of 3 eNodeB and 1 UE in piecewise configuration and 240 ms report interval.
This test is to cover a corner case using event A4, which is not covered by LteUeMeasurementsPiecewiseTestCase1 and LteUeMeasurementsPiecewiseTestCase2. In this case, we test that the UE measurements at eNB are arriving 240 ms apart. Please note, the scenario simulated is engineered to specifically test the corner case in which whenever a new neighbour fulfils the entry condition for event A4, the UE RRC calls VarMeasReportListAdd method to include the new cell id in cellsTriggeredList, and then it schedules the SendMeasurementReport for periodic reporting. However, if the UE has already started the periodic reporting, scheduling the SendMeasurementReport method again causes following buggy behaviors:
These buggy behaviors generated an issue reported in https://gitlab.com/nsnam/ns-3-dev/-/issues/224, where a UE try to send measurement reports after the RLF, even though all the measurement events are properly cancelled upon detecting RLF.
The correct behaviour should be that if a UE has already started the periodic reporting, and once a new neighbour fulfils the entry condition, we just need to add its cell id in cellsTriggeredList, without scheduling a new periodic event.
Definition at line 444 of file lte-test-ue-measurements.h.
LteUeMeasurementsPiecewiseTestCase3::LteUeMeasurementsPiecewiseTestCase3 | ( | std::string | name, |
LteRrcSap::ReportConfigEutra | config, | ||
std::vector< Time > | expectedTime | ||
) |
Constructor.
name | the reference name |
config | LteRrcSap::ReportConfigEutra |
expectedTime | the expected time |
Definition at line 1740 of file lte-test-ue-measurements.cc.
References m_expectedMeasId, m_expectedTime, m_itExpectedTime, max, and NS_LOG_INFO.
|
override |
Definition at line 1755 of file lte-test-ue-measurements.cc.
References NS_LOG_FUNCTION.
|
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 1761 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_enbMobility, m_expectedMeasId, ns3::MakeCallback(), ns3::MilliSeconds(), third::mobility, NS_LOG_INFO, RecvMeasurementReportCallback(), ns3::Seconds(), ns3::ObjectBase::SetAttribute(), ns3::Config::SetDefault(), ns3::LteHelper::SetSchedulerAttribute(), ns3::LteHelper::SetSchedulerType(), and TeleportEnbNear().
|
overrideprivatevirtual |
Runs at the end of the simulation, verifying that all expected measurement reports have been examined.
Reimplemented from ns3::TestCase.
Definition at line 1855 of file lte-test-ue-measurements.cc.
References m_expectedTime, m_itExpectedTime, NS_LOG_FUNCTION, and NS_TEST_ASSERT_MSG_EQ.
void LteUeMeasurementsPiecewiseTestCase3::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.
context | the context |
imsi | the IMSI |
cellId | the cell ID |
rnti | the RNTI |
report | LteRrcSap::MeasurementReport |
Definition at line 1866 of file lte-test-ue-measurements.cc.
References ns3::Time::GetMilliSeconds(), ns3::LteRrcSap::MeasResults::haveMeasResultNeighCells, m_expectedMeasId, m_expectedTime, 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().
|
private |
Teleport the eNb near function.
Definition at line 1950 of file lte-test-ue-measurements.cc.
References m_enbMobility, NS_LOG_FUNCTION, and ns3::MobilityModel::SetPosition().
Referenced by DoRun().
|
private |
The active report triggering configuration.
Definition at line 503 of file lte-test-ue-measurements.h.
Referenced by DoRun().
|
private |
the mobility model
Definition at line 524 of file lte-test-ue-measurements.h.
Referenced by DoRun(), and TeleportEnbNear().
|
private |
The measurement identity being tested.
Measurement reports with different measurement identity (e.g. from handover algorithm) will be ignored.
Definition at line 522 of file lte-test-ue-measurements.h.
Referenced by LteUeMeasurementsPiecewiseTestCase3(), DoRun(), and RecvMeasurementReportCallback().
|
private |
The list of expected time when measurement reports are received by eNodeB.
Definition at line 509 of file lte-test-ue-measurements.h.
Referenced by LteUeMeasurementsPiecewiseTestCase3(), DoTeardown(), and RecvMeasurementReportCallback().
|
private |
Pointer to the element of m_expectedTime
which is expected to occur next in the simulation.
Definition at line 515 of file lte-test-ue-measurements.h.
Referenced by LteUeMeasurementsPiecewiseTestCase3(), DoTeardown(), and RecvMeasurementReportCallback().