A Discrete-Event Network Simulator
API
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
lte-test-link-adaptation.cc
Go to the documentation of this file.
1 /* -*- Mode: C++; c-file-style: "gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2011 Centre Tecnologic de Telecomunicacions de Catalunya (CTTC)
4  *
5  * This program is free software; you can redistribute it and/or modify
6  * it under the terms of the GNU General Public License version 2 as
7  * published by the Free Software Foundation;
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software
16  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17  *
18  * Author: Manuel Requena <manuel.requena@cttc.es>
19  */
20 
21 #include "ns3/simulator.h"
22 #include "ns3/log.h"
23 #include "ns3/string.h"
24 #include "ns3/double.h"
25 #include <ns3/enum.h>
26 
27 #include "ns3/mobility-helper.h"
28 #include "ns3/lte-helper.h"
29 
30 #include "ns3/lte-ue-phy.h"
31 #include "ns3/lte-ue-net-device.h"
32 
33 #include "lte-test-link-adaptation.h"
34 
35 #include "lte-test-sinr-chunk-processor.h"
36 
37 NS_LOG_COMPONENT_DEFINE ("LteLinkAdaptationTest");
38 
39 namespace ns3 {
40 
41 
46 void
47 LteTestDlSchedulingCallback (LteLinkAdaptationTestCase *testcase, std::string path,
48  uint32_t frameNo, uint32_t subframeNo, uint16_t rnti,
49  uint8_t mcsTb1, uint16_t sizeTb1, uint8_t mcsTb2, uint16_t sizeTb2)
50 {
51  testcase->DlScheduling (frameNo, subframeNo, rnti, mcsTb1, sizeTb1, mcsTb2, sizeTb2);
52 }
53 
58 LteLinkAdaptationTestSuite::LteLinkAdaptationTestSuite ()
59  : TestSuite ("lte-link-adaptation", SYSTEM)
60 {
61  NS_LOG_INFO ("Creating LteLinkAdaptionTestSuite");
62 
63  struct SnrEfficiencyMcs
64  {
65  double snrDb;
66  double efficiency;
67  int mcsIndex;
68  };
69 
74  SnrEfficiencyMcs snrEfficiencyMcs[] = {
75  { -5.00000, 0.08024, -1},
76  { -4.00000, 0.10030, -1},
77  { -3.00000, 0.12518, -1},
78  { -2.00000, 0.15589, 0},
79  { -1.00000, 0.19365, 0},
80  { 0.00000, 0.23983, 2},
81  { 1.00000, 0.29593, 2},
82  { 2.00000, 0.36360, 2},
83  { 3.00000, 0.44451, 4},
84  { 4.00000, 0.54031, 4},
85  { 5.00000, 0.65251, 6},
86  { 6.00000, 0.78240, 6},
87  { 7.00000, 0.93086, 8},
88  { 8.00000, 1.09835, 8},
89  { 9.00000, 1.28485, 10},
90  { 10.00000, 1.48981, 12},
91  { 11.00000, 1.71229, 12},
92  { 12.00000, 1.95096, 14},
93  { 13.00000, 2.20429, 14},
94  { 14.00000, 2.47062, 16},
95  { 15.00000, 2.74826, 18},
96  { 16.00000, 3.03560, 18},
97  { 17.00000, 3.33115, 20},
98  { 18.00000, 3.63355, 20},
99  { 19.00000, 3.94163, 22},
100  { 20.00000, 4.25439, 22},
101  { 21.00000, 4.57095, 24},
102  { 22.00000, 4.89060, 24},
103  { 23.00000, 5.21276, 26},
104  { 24.00000, 5.53693, 26},
105  { 25.00000, 5.86271, 28},
106  { 26.00000, 6.18980, 28},
107  { 27.00000, 6.51792, 28},
108  { 28.00000, 6.84687, 28},
109  { 29.00000, 7.17649, 28},
110  { 30.00000, 7.50663, 28},
111  };
112  int numOfTests = sizeof (snrEfficiencyMcs) / sizeof (SnrEfficiencyMcs);
113 
114  double txPowerDbm = 30; // default eNB TX power over whole bandwidth
115  double ktDbm = -174; // reference LTE noise PSD
116  double noisePowerDbm = ktDbm + 10 * std::log10 (25 * 180000); // corresponds to kT*bandwidth in linear units
117  double receiverNoiseFigureDb = 9.0; // default UE noise figure
118 
119  for ( int i = 0 ; i < numOfTests; i++ )
120  {
121  double lossDb = txPowerDbm - snrEfficiencyMcs[i].snrDb - noisePowerDbm - receiverNoiseFigureDb;
122 
123  std::ostringstream name;
124  name << " snr= " << snrEfficiencyMcs[i].snrDb << " dB, "
125  << " mcs= " << snrEfficiencyMcs[i].mcsIndex;
126  AddTestCase (new LteLinkAdaptationTestCase (name.str (), snrEfficiencyMcs[i].snrDb, lossDb, snrEfficiencyMcs[i].mcsIndex));
127  }
128 
129 }
130 
131 static LteLinkAdaptationTestSuite lteLinkAdaptationTestSuite;
132 
133 
138 LteLinkAdaptationTestCase::LteLinkAdaptationTestCase (std::string name, double snrDb, double loss, uint16_t mcsIndex)
139  : TestCase (name),
140  m_snrDb (snrDb),
141  m_loss (loss),
142  m_mcsIndex (mcsIndex)
143 {
144  std::ostringstream sstream1, sstream2;
145  sstream1 << " snr=" << snrDb
146  << " mcs=" << mcsIndex;
147 
148  NS_LOG_INFO ("Creating LteLinkAdaptationTestCase: " + sstream1.str ());
149 }
150 
151 LteLinkAdaptationTestCase::~LteLinkAdaptationTestCase ()
152 {
153 }
154 
155 void
156 LteLinkAdaptationTestCase::DoRun (void)
157 {
158 
159  Config::SetDefault ("ns3::LteAmc::AmcModel", EnumValue (LteAmc::PiroEW2010));
160  Config::SetDefault ("ns3::LteAmc::Ber", DoubleValue (0.00005));
165  Ptr<LteHelper> lteHelper = CreateObject<LteHelper> ();
166 // lteHelper->EnableLogComponents ();
167  lteHelper->EnableMacTraces ();
168  lteHelper->EnableRlcTraces ();
169  lteHelper->SetAttribute ("PathlossModel", StringValue ("ns3::ConstantSpectrumPropagationLossModel"));
170  NS_LOG_INFO ("SNR = " << m_snrDb << " LOSS = " << m_loss);
171  lteHelper->SetPathlossModelAttribute ("Loss", DoubleValue (m_loss));
172 
173  // Create Nodes: eNodeB and UE
174  NodeContainer enbNodes;
175  NodeContainer ueNodes;
176  enbNodes.Create (1);
177  ueNodes.Create (1);
178  NodeContainer allNodes = NodeContainer ( enbNodes, ueNodes );
179 
180  // Install Mobility Model
181  MobilityHelper mobility;
182  mobility.SetMobilityModel ("ns3::ConstantPositionMobilityModel");
183  mobility.Install (allNodes);
184 
185  // Create Devices and install them in the Nodes (eNB and UE)
186  NetDeviceContainer enbDevs;
187  NetDeviceContainer ueDevs;
188  lteHelper->SetSchedulerType ("ns3::RrFfMacScheduler");
189  enbDevs = lteHelper->InstallEnbDevice (enbNodes);
190  ueDevs = lteHelper->InstallUeDevice (ueNodes);
191 
192  // Attach a UE to a eNB
193  lteHelper->Attach (ueDevs, enbDevs.Get (0));
194 
195  // Activate the default EPS bearer
196  enum EpsBearer::Qci q = EpsBearer::NGBR_VIDEO_TCP_DEFAULT;
197  EpsBearer bearer (q);
198  lteHelper->ActivateEpsBearer (ueDevs, bearer, EpcTft::Default ());
199 
200  // Use testing chunk processor in the PHY layer
201  // It will be used to test that the SNR is as intended
202  Ptr<LtePhy> uePhy = ueDevs.Get (0)->GetObject<LteUeNetDevice> ()->GetPhy ()->GetObject<LtePhy> ();
203  Ptr<LteTestSinrChunkProcessor> testSinr = Create<LteTestSinrChunkProcessor> (uePhy);
204  uePhy->GetDownlinkSpectrumPhy ()->AddDataSinrChunkProcessor (testSinr);
205 
206  Config::Connect ("/NodeList/0/DeviceList/0/LteEnbMac/DlScheduling",
207  MakeBoundCallback (&LteTestDlSchedulingCallback, this));
208 
209  Simulator::Stop (Seconds (0.007));
210  Simulator::Run ();
211 
212  double calculatedSinrDb = 10.0 * std::log10 (testSinr->GetSinr ()->operator[] (0));
213  NS_TEST_ASSERT_MSG_EQ_TOL (calculatedSinrDb, m_snrDb, 0.0000001, "Wrong SINR !");
214  Simulator::Destroy ();
215 }
216 
217 
218 void
219 LteLinkAdaptationTestCase::DlScheduling (uint32_t frameNo, uint32_t subframeNo, uint16_t rnti,
220  uint8_t mcsTb1, uint16_t sizeTb1, uint8_t mcsTb2, uint16_t sizeTb2)
221 {
222  static bool firstTime = true;
223 
224  if ( firstTime )
225  {
226  firstTime = false;
227  NS_LOG_INFO ("SNR\tRef_MCS\tCalc_MCS");
228  }
229 
235  if ( (frameNo > 1) || (subframeNo > 8) )
236  {
237  NS_LOG_INFO (m_snrDb << "\t" << m_mcsIndex << "\t" << (uint16_t)mcsTb1);
238 
239  NS_TEST_ASSERT_MSG_EQ ((uint16_t)mcsTb1, m_mcsIndex, "Wrong MCS index");
240  }
241 }
242 
243 } // namespace ns3
244