nr-system-test-configurations.cc

Go to the documentation of this file.

// Copyright (c) 2019 Centre Tecnologic de Telecomunicacions de Catalunya (CTTC)
//
// SPDX-License-Identifier: GPL-2.0-only
 
// Include a header file from your module to test.
#include "ns3/applications-module.h"
#include "ns3/config-store-module.h"
#include "ns3/core-module.h"
#include "ns3/internet-module.h"
#include "ns3/mobility-module.h"
#include "ns3/network-module.h"
#include "ns3/nr-module.h"
#include "ns3/point-to-point-helper.h"
 
using namespace ns3;
 
// This is an example TestCase.
class NrSystemTestConfigurationsTestCase1 : public TestCase
{
  public:
    NrSystemTestConfigurationsTestCase1(std::string name,
                                        uint32_t numerology,
                                        std::string scheduler);
    ~NrSystemTestConfigurationsTestCase1() override;
 
  private:
    void DoRun() override;
 
    uint32_t m_numerology;
    std::string m_scheduler;
};
 
NrSystemTestConfigurationsTestCase1::NrSystemTestConfigurationsTestCase1(std::string name,
                                                                         uint32_t numerology,
                                                                         std::string scheduler)
    : TestCase(name)
{
    m_numerology = numerology;
    m_scheduler = scheduler;
}
 
NrSystemTestConfigurationsTestCase1::~NrSystemTestConfigurationsTestCase1()
{
}
 
void
NrSystemTestConfigurationsTestCase1::DoRun()
{
    // set mobile device and base station antenna heights in meters, according to the chosen
    // scenario
    double hBS = 35.0; // base station antenna height in meters;
    double hUT = 1.5;  // user antenna height in meters;
 
    // create base stations and mobile terminals
    NodeContainer gnbNode;
    NodeContainer ueNode;
    gnbNode.Create(1);
    ueNode.Create(1);
 
    // position the base stations
    Ptr<ListPositionAllocator> gnbPositionAlloc = CreateObject<ListPositionAllocator>();
    gnbPositionAlloc->Add(Vector(0.0, 0.0, hBS));
 
    MobilityHelper gnbMobility;
    gnbMobility.SetMobilityModel("ns3::ConstantPositionMobilityModel");
    gnbMobility.SetPositionAllocator(gnbPositionAlloc);
    gnbMobility.Install(gnbNode);
 
    // position the mobile terminals and enable the mobility
    MobilityHelper uemobility;
    uemobility.SetMobilityModel("ns3::ConstantVelocityMobilityModel");
    uemobility.Install(ueNode);
 
    ueNode.Get(0)->GetObject<MobilityModel>()->SetPosition(Vector(0, 10, hUT));
 
    Ptr<NrPointToPointEpcHelper> nrEpcHelper = CreateObject<NrPointToPointEpcHelper>();
    Ptr<IdealBeamformingHelper> idealBeamformingHelper = CreateObject<IdealBeamformingHelper>();
    Ptr<NrHelper> nrHelper = CreateObject<NrHelper>();
 
    // Put the pointers inside nrHelper
    nrHelper->SetBeamformingHelper(idealBeamformingHelper);
    nrHelper->SetEpcHelper(nrEpcHelper);
    Ptr<NrChannelHelper> channelHelper = CreateObject<NrChannelHelper>();
    // Set the channel with UMi scenario
    channelHelper->ConfigureFactories("UMi");
    // Set spectrum attributes
    Config::SetDefault("ns3::ThreeGppChannelModel::UpdatePeriod", TimeValue(MilliSeconds(100)));
 
    channelHelper->SetChannelConditionModelAttribute("UpdatePeriod", TimeValue(MilliSeconds(100)));
    channelHelper->SetPathlossAttribute("ShadowingEnabled", BooleanValue(false));
    BandwidthPartInfoPtrVector allBwps;
    CcBwpCreator ccBwpCreator;
    const uint8_t numCcPerBand = 1; // in this example, both bands have a single CC
 
    // Create the configuration for the CcBwpHelper. SimpleOperationBandConf creates
    // a single BWP per CC
    CcBwpCreator::SimpleOperationBandConf bandConf1(28e9, 100e6, numCcPerBand);
 
    // By using the configuration created, it is time to make the operation bands
    OperationBandInfo band1 = ccBwpCreator.CreateOperationBandContiguousCc(bandConf1);
    // Set the channel for the band
    channelHelper->AssignChannelsToBands({band1});
    allBwps = CcBwpCreator::GetAllBwps({band1});
 
    nrHelper->SetGnbPhyAttribute("Numerology", UintegerValue(m_numerology));
    nrHelper->SetSchedulerTypeId(TypeId::LookupByName(m_scheduler));
 
    // install nr net devices
    NetDeviceContainer gnbNetDev = nrHelper->InstallGnbDevice(gnbNode, allBwps);
    NetDeviceContainer ueNetDev = nrHelper->InstallUeDevice(ueNode, allBwps);
 
    // create the internet and install the IP stack on the UEs
    // get SGW/PGW and create a single RemoteHost
    auto [remoteHost, remoteHostIpv4Address] =
        nrEpcHelper->SetupRemoteHost("100Gb/s", 2500, Seconds(0.000));
 
    InternetStackHelper internet;
    internet.Install(ueNode);
    Ipv4InterfaceContainer ueIpIface;
    ueIpIface = nrEpcHelper->AssignUeIpv4Address(NetDeviceContainer(ueNetDev));
 
    // assign IP address to UEs, and install UDP downlink applications
    uint16_t dlPort = 1234;
    ApplicationContainer clientApps;
    ApplicationContainer serverApps;
 
    UdpServerHelper dlPacketSinkHelper(dlPort);
    serverApps.Add(dlPacketSinkHelper.Install(ueNode.Get(0)));
 
    UdpClientHelper dlClient(ueIpIface.GetAddress(0), dlPort);
    dlClient.SetAttribute("Interval", TimeValue(MicroSeconds(10000)));
    dlClient.SetAttribute("MaxPackets", UintegerValue(0xFFFFFFFF));
    clientApps.Add(dlClient.Install(remoteHost));
 
    // start server and client apps
    serverApps.Start(MilliSeconds(400));
    clientApps.Start(MilliSeconds(400));
    serverApps.Stop(MilliSeconds(800));
    clientApps.Stop(MilliSeconds(800));
 
    // attach UEs to the closest gNB
    nrHelper->AttachToClosestGnb(ueNetDev, gnbNetDev);
 
    Simulator::Stop(MilliSeconds(800));
    Simulator::Run();
    Simulator::Destroy();
 
    // A wide variety of test macros are available in src/core/test.h
    NS_TEST_ASSERT_MSG_EQ(true, true, "true doesn't equal true for some reason");
    // Use this one for floating point comparisons
    NS_TEST_ASSERT_MSG_EQ_TOL(0.01, 0.01, 0.001, "Numbers are not equal within tolerance");
}
 
class NrSystemTestConfigurationsTestSuite : public TestSuite
{
  public:
    NrSystemTestConfigurationsTestSuite();
};
 
NrSystemTestConfigurationsTestSuite::NrSystemTestConfigurationsTestSuite()
    : TestSuite("nr-system-test-configurations", Type::SYSTEM)
{
    AddTestCase(new NrSystemTestConfigurationsTestCase1("num=0, scheduler=rr",
                                                        0,
                                                        "ns3::NrMacSchedulerTdmaRR"),
                Duration::QUICK);
    AddTestCase(new NrSystemTestConfigurationsTestCase1("num=2, scheduler=rr",
                                                        2,
                                                        "ns3::NrMacSchedulerTdmaRR"),
                Duration::QUICK);
    AddTestCase(new NrSystemTestConfigurationsTestCase1("num=4, scheduler=rr",
                                                        4,
                                                        "ns3::NrMacSchedulerTdmaRR"),
                Duration::QUICK);
 
    AddTestCase(new NrSystemTestConfigurationsTestCase1("num=0, scheduler=pf",
                                                        0,
                                                        "ns3::NrMacSchedulerTdmaPF"),
                Duration::QUICK);
    AddTestCase(new NrSystemTestConfigurationsTestCase1("num=2, scheduler=pf",
                                                        2,
                                                        "ns3::NrMacSchedulerTdmaPF"),
                Duration::QUICK);
    AddTestCase(new NrSystemTestConfigurationsTestCase1("num=4, scheduler=pf",
                                                        4,
                                                        "ns3::NrMacSchedulerTdmaPF"),
                Duration::QUICK);
 
    AddTestCase(new NrSystemTestConfigurationsTestCase1("num=0, scheduler=mr",
                                                        0,
                                                        "ns3::NrMacSchedulerTdmaMR"),
                Duration::QUICK);
    AddTestCase(new NrSystemTestConfigurationsTestCase1("num=2, scheduler=mr",
                                                        2,
                                                        "ns3::NrMacSchedulerTdmaMR"),
                Duration::QUICK);
    AddTestCase(new NrSystemTestConfigurationsTestCase1("num=4, scheduler=mr",
                                                        4,
                                                        "ns3::NrMacSchedulerTdmaMR"),
                Duration::QUICK);
}
 
// Do not forget to allocate an instance of this TestSuite
static NrSystemTestConfigurationsTestSuite nrTestSuite;