lte-test-interference.cc

Go to the documentation of this file.

/*
 * Copyright (c) 2011 Centre Tecnologic de Telecomunicacions de Catalunya (CTTC)
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License version 2 as
 * published by the Free Software Foundation;
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 *
 * Author: Manuel Requena <manuel.requena@cttc.es>
 *         Nicola Baldo <nbaldo@cttc.es>
 */
 
#include "lte-test-interference.h"
 
#include "ns3/boolean.h"
#include "ns3/double.h"
#include "ns3/ff-mac-scheduler.h"
#include "ns3/log.h"
#include "ns3/lte-enb-net-device.h"
#include "ns3/lte-enb-phy.h"
#include "ns3/lte-helper.h"
#include "ns3/lte-ue-net-device.h"
#include "ns3/lte-ue-phy.h"
#include "ns3/mobility-helper.h"
#include "ns3/simulator.h"
#include "ns3/string.h"
#include <ns3/enum.h>
#include <ns3/lte-chunk-processor.h>
 
using namespace ns3;
 
NS_LOG_COMPONENT_DEFINE("LteInterferenceTest");
 
void
LteTestDlSchedulingCallback(LteInterferenceTestCase* testcase,
                            std::string path,
                            DlSchedulingCallbackInfo dlInfo)
{
    testcase->DlScheduling(dlInfo);
}
 
void
LteTestUlSchedulingCallback(LteInterferenceTestCase* testcase,
                            std::string path,
                            uint32_t frameNo,
                            uint32_t subframeNo,
                            uint16_t rnti,
                            uint8_t mcs,
                            uint16_t sizeTb,
                            uint8_t ccId)
{
    testcase->UlScheduling(frameNo, subframeNo, rnti, mcs, sizeTb);
}
 
/**
 * TestSuite
 */
 
LteInterferenceTestSuite::LteInterferenceTestSuite()
    : TestSuite("lte-interference", Type::SYSTEM)
{
    // these two first test cases have a spectral efficiency that corresponds to CQI=0 (out of
    // range)
    // TODO: update the test conditions to handle out-of-range correctly
    // AddTestCase (new LteInterferenceTestCase ("d1=50, d2=10",  50.000000, 10.000000,  0.040000,
    // 0.040000,  0.010399, 0.010399, 0, 0), TestCase::Duration::QUICK); AddTestCase (new
    // LteInterferenceTestCase ("d1=50, d2=20",  50.000000, 20.000000,  0.160000, 0.159998,
    // 0.041154, 0.041153, 0, 0), TestCase::Duration::QUICK);
 
    AddTestCase(new LteInterferenceTestCase("d1=3000, d2=6000",
                                            3000.000000,
                                            6000.000000,
                                            3.844681,
                                            1.714583,
                                            0.761558,
                                            0.389662,
                                            6,
                                            4),
                TestCase::Duration::QUICK);
    AddTestCase(new LteInterferenceTestCase("d1=50, d2=50",
                                            50.000000,
                                            50.000000,
                                            0.999997,
                                            0.999907,
                                            0.239828,
                                            0.239808,
                                            2,
                                            2),
                TestCase::Duration::QUICK);
    AddTestCase(new LteInterferenceTestCase("d1=50, d2=100",
                                            50.000000,
                                            100.000000,
                                            3.999955,
                                            3.998520,
                                            0.785259,
                                            0.785042,
                                            6,
                                            6),
                TestCase::Duration::QUICK);
    AddTestCase(new LteInterferenceTestCase("d1=50, d2=200",
                                            50.000000,
                                            200.000000,
                                            15.999282,
                                            15.976339,
                                            1.961072,
                                            1.959533,
                                            14,
                                            14),
                TestCase::Duration::QUICK);
    AddTestCase(new LteInterferenceTestCase("d1=50, d2=500",
                                            50.000000,
                                            500.000000,
                                            99.971953,
                                            99.082845,
                                            4.254003,
                                            4.241793,
                                            22,
                                            22),
                TestCase::Duration::QUICK);
    AddTestCase(new LteInterferenceTestCase("d1=50, d2=1000",
                                            50.000000,
                                            1000.000000,
                                            399.551632,
                                            385.718468,
                                            6.194952,
                                            6.144825,
                                            28,
                                            28),
                TestCase::Duration::QUICK);
    AddTestCase(new LteInterferenceTestCase("d1=50, d2=10000",
                                            50.000000,
                                            10000.000000,
                                            35964.181431,
                                            8505.970614,
                                            12.667381,
                                            10.588084,
                                            28,
                                            28),
                TestCase::Duration::QUICK);
    AddTestCase(new LteInterferenceTestCase("d1=50, d2=100000",
                                            50.000000,
                                            100000.000000,
                                            327284.773828,
                                            10774.181090,
                                            15.853097,
                                            10.928917,
                                            28,
                                            28),
                TestCase::Duration::QUICK);
    AddTestCase(new LteInterferenceTestCase("d1=50, d2=1000000",
                                            50.000000,
                                            1000000.000000,
                                            356132.574152,
                                            10802.988445,
                                            15.974963,
                                            10.932767,
                                            28,
                                            28),
                TestCase::Duration::QUICK);
    AddTestCase(new LteInterferenceTestCase("d1=4500, d2=12600",
                                            4500.000000,
                                            12600.000000,
                                            6.654462,
                                            1.139831,
                                            1.139781,
                                            0.270399,
                                            8,
                                            2),
                TestCase::Duration::QUICK);
    AddTestCase(new LteInterferenceTestCase("d1=5400, d2=12600",
                                            5400.000000,
                                            12600.000000,
                                            4.621154,
                                            0.791549,
                                            0.876368,
                                            0.193019,
                                            6,
                                            0),
                TestCase::Duration::QUICK);
}
 
/**
 * \ingroup lte-test
 * Static variable for test initialization
 */
static LteInterferenceTestSuite lteLinkAdaptationWithInterferenceTestSuite;
 
/**
 * TestCase
 */
 
LteInterferenceTestCase::LteInterferenceTestCase(std::string name,
                                                 double d1,
                                                 double d2,
                                                 double dlSinr,
                                                 double ulSinr,
                                                 double dlSe,
                                                 double ulSe,
                                                 uint16_t dlMcs,
                                                 uint16_t ulMcs)
    : TestCase(name),
      m_d1(d1),
      m_d2(d2),
      m_expectedDlSinrDb(10 * std::log10(dlSinr)),
      m_expectedUlSinrDb(10 * std::log10(ulSinr)),
      m_dlMcs(dlMcs),
      m_ulMcs(ulMcs)
{
}
 
LteInterferenceTestCase::~LteInterferenceTestCase()
{
}
 
void
LteInterferenceTestCase::DoRun()
{
    NS_LOG_INFO(this << GetName());
 
    Config::SetDefault("ns3::LteSpectrumPhy::CtrlErrorModelEnabled", BooleanValue(false));
    Config::SetDefault("ns3::LteSpectrumPhy::DataErrorModelEnabled", BooleanValue(false));
    Config::SetDefault("ns3::LteAmc::AmcModel", EnumValue(LteAmc::PiroEW2010));
    Config::SetDefault("ns3::LteAmc::Ber", DoubleValue(0.00005));
    Ptr<LteHelper> lteHelper = CreateObject<LteHelper>();
    lteHelper->SetAttribute("PathlossModel", StringValue("ns3::FriisSpectrumPropagationLossModel"));
    lteHelper->SetAttribute("UseIdealRrc", BooleanValue(false));
    lteHelper->SetAttribute("UsePdschForCqiGeneration", BooleanValue(true));
 
    // Disable Uplink Power Control
    Config::SetDefault("ns3::LteUePhy::EnableUplinkPowerControl", BooleanValue(false));
 
    // Create Nodes: eNodeB and UE
    NodeContainer enbNodes;
    NodeContainer ueNodes1;
    NodeContainer ueNodes2;
    enbNodes.Create(2);
    ueNodes1.Create(1);
    ueNodes2.Create(1);
    NodeContainer allNodes = NodeContainer(enbNodes, ueNodes1, ueNodes2);
 
    // the topology is the following:
    //         d2
    //  UE1-----------eNB2
    //   |             |
    // d1|             |d1
    //   |     d2      |
    //  eNB1----------UE2
    //
    Ptr<ListPositionAllocator> positionAlloc = CreateObject<ListPositionAllocator>();
    positionAlloc->Add(Vector(0.0, 0.0, 0.0));   // eNB1
    positionAlloc->Add(Vector(m_d2, m_d1, 0.0)); // eNB2
    positionAlloc->Add(Vector(0.0, m_d1, 0.0));  // UE1
    positionAlloc->Add(Vector(m_d2, 0.0, 0.0));  // UE2
    MobilityHelper mobility;
    mobility.SetMobilityModel("ns3::ConstantPositionMobilityModel");
    mobility.SetPositionAllocator(positionAlloc);
    mobility.Install(allNodes);
 
    // Create Devices and install them in the Nodes (eNB and UE)
    NetDeviceContainer enbDevs;
    NetDeviceContainer ueDevs1;
    NetDeviceContainer ueDevs2;
    lteHelper->SetSchedulerType("ns3::RrFfMacScheduler");
    lteHelper->SetSchedulerAttribute("UlCqiFilter", EnumValue(FfMacScheduler::PUSCH_UL_CQI));
    enbDevs = lteHelper->InstallEnbDevice(enbNodes);
    ueDevs1 = lteHelper->InstallUeDevice(ueNodes1);
    ueDevs2 = lteHelper->InstallUeDevice(ueNodes2);
 
    lteHelper->Attach(ueDevs1, enbDevs.Get(0));
    lteHelper->Attach(ueDevs2, enbDevs.Get(1));
 
    // Activate an EPS bearer
    EpsBearer::Qci q = EpsBearer::GBR_CONV_VOICE;
    EpsBearer bearer(q);
    lteHelper->ActivateDataRadioBearer(ueDevs1, bearer);
    lteHelper->ActivateDataRadioBearer(ueDevs2, bearer);
 
    // Use testing chunk processor in the PHY layer
    // It will be used to test that the SNR is as intended
    // we plug in two instances, one for DL and one for UL
 
    Ptr<LtePhy> ue1Phy = ueDevs1.Get(0)->GetObject<LteUeNetDevice>()->GetPhy()->GetObject<LtePhy>();
    Ptr<LteChunkProcessor> testDlSinr1 = Create<LteChunkProcessor>();
    LteSpectrumValueCatcher dlSinr1Catcher;
    testDlSinr1->AddCallback(MakeCallback(&LteSpectrumValueCatcher::ReportValue, &dlSinr1Catcher));
    ue1Phy->GetDownlinkSpectrumPhy()->AddDataSinrChunkProcessor(testDlSinr1);
 
    Ptr<LtePhy> enb1phy =
        enbDevs.Get(0)->GetObject<LteEnbNetDevice>()->GetPhy()->GetObject<LtePhy>();
    Ptr<LteChunkProcessor> testUlSinr1 = Create<LteChunkProcessor>();
    LteSpectrumValueCatcher ulSinr1Catcher;
    testUlSinr1->AddCallback(MakeCallback(&LteSpectrumValueCatcher::ReportValue, &ulSinr1Catcher));
    enb1phy->GetUplinkSpectrumPhy()->AddDataSinrChunkProcessor(testUlSinr1);
 
    Config::Connect("/NodeList/0/DeviceList/0/ComponentCarrierMap/*/LteEnbMac/DlScheduling",
                    MakeBoundCallback(&LteTestDlSchedulingCallback, this));
 
    Config::Connect("/NodeList/0/DeviceList/0/ComponentCarrierMap/*/LteEnbMac/UlScheduling",
                    MakeBoundCallback(&LteTestUlSchedulingCallback, this));
 
    // same as above for eNB2 and UE2
 
    Ptr<LtePhy> ue2Phy = ueDevs2.Get(0)->GetObject<LteUeNetDevice>()->GetPhy()->GetObject<LtePhy>();
    Ptr<LteChunkProcessor> testDlSinr2 = Create<LteChunkProcessor>();
    LteSpectrumValueCatcher dlSinr2Catcher;
    testDlSinr2->AddCallback(MakeCallback(&LteSpectrumValueCatcher::ReportValue, &dlSinr2Catcher));
    ue2Phy->GetDownlinkSpectrumPhy()->AddDataSinrChunkProcessor(testDlSinr2);
 
    Ptr<LtePhy> enb2phy =
        enbDevs.Get(1)->GetObject<LteEnbNetDevice>()->GetPhy()->GetObject<LtePhy>();
    Ptr<LteChunkProcessor> testUlSinr2 = Create<LteChunkProcessor>();
    LteSpectrumValueCatcher ulSinr2Catcher;
    testUlSinr2->AddCallback(MakeCallback(&LteSpectrumValueCatcher::ReportValue, &ulSinr2Catcher));
    enb1phy->GetUplinkSpectrumPhy()->AddDataSinrChunkProcessor(testUlSinr2);
 
    Config::Connect("/NodeList/1/DeviceList/0/ComponentCarrierMap/*/LteEnbMac/DlScheduling",
                    MakeBoundCallback(&LteTestDlSchedulingCallback, this));
 
    Config::Connect("/NodeList/1/DeviceList/0/ComponentCarrierMap/*/LteEnbMac/UlScheduling",
                    MakeBoundCallback(&LteTestUlSchedulingCallback, this));
 
    // need to allow for RRC connection establishment + SRS
    Simulator::Stop(Seconds(0.100));
    Simulator::Run();
 
    if (m_dlMcs > 0)
    {
        double dlSinr1Db = 10.0 * std::log10(dlSinr1Catcher.GetValue()->operator[](0));
        NS_TEST_ASSERT_MSG_EQ_TOL(dlSinr1Db,
                                  m_expectedDlSinrDb,
                                  0.01,
                                  "Wrong SINR in DL! (eNB1 --> UE1)");
 
        double dlSinr2Db = 10.0 * std::log10(dlSinr2Catcher.GetValue()->operator[](0));
        NS_TEST_ASSERT_MSG_EQ_TOL(dlSinr2Db,
                                  m_expectedDlSinrDb,
                                  0.01,
                                  "Wrong SINR in DL! (eNB2 --> UE2)");
    }
    if (m_ulMcs > 0)
    {
        double ulSinr1Db = 10.0 * std::log10(ulSinr1Catcher.GetValue()->operator[](0));
        NS_TEST_ASSERT_MSG_EQ_TOL(ulSinr1Db,
                                  m_expectedUlSinrDb,
                                  0.01,
                                  "Wrong SINR in UL!  (UE1 --> eNB1)");
 
        double ulSinr2Db = 10.0 * std::log10(ulSinr2Catcher.GetValue()->operator[](0));
        NS_TEST_ASSERT_MSG_EQ_TOL(ulSinr2Db,
                                  m_expectedUlSinrDb,
                                  0.01,
                                  "Wrong SINR in UL!  (UE2 --> eNB2)");
    }
 
    Simulator::Destroy();
}
 
void
LteInterferenceTestCase::DlScheduling(DlSchedulingCallbackInfo dlInfo)
{
    NS_LOG_FUNCTION(dlInfo.frameNo << dlInfo.subframeNo << dlInfo.rnti << (uint32_t)dlInfo.mcsTb1
                                   << dlInfo.sizeTb1 << (uint32_t)dlInfo.mcsTb2 << dlInfo.sizeTb2);
    // need to allow for RRC connection establishment + CQI feedback reception + persistent data
    // transmission
    if (Simulator::Now() > MilliSeconds(65))
    {
        NS_TEST_ASSERT_MSG_EQ((uint32_t)dlInfo.mcsTb1, (uint32_t)m_dlMcs, "Wrong DL MCS ");
    }
}
 
void
LteInterferenceTestCase::UlScheduling(uint32_t frameNo,
                                      uint32_t subframeNo,
                                      uint16_t rnti,
                                      uint8_t mcs,
                                      uint16_t sizeTb)
{
    NS_LOG_FUNCTION(frameNo << subframeNo << rnti << (uint32_t)mcs << sizeTb);
    // need to allow for RRC connection establishment + SRS transmission
    if (Simulator::Now() > MilliSeconds(50))
    {
        NS_TEST_ASSERT_MSG_EQ((uint32_t)mcs, (uint32_t)m_ulMcs, "Wrong UL MCS");
    }
}