A Discrete-Event Network Simulator
API
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
lte-test-rr-ff-mac-scheduler.cc
Go to the documentation of this file.
1 /* -*- Mode: C++; c-file-style: "gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2011, 2012 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: Marco Miozzo <marco.miozzo@cttc.es>
19  * Nicola Baldo <nbaldo@cttc.es>
20  */
21 
22 #include <ns3/object.h>
23 #include <ns3/spectrum-interference.h>
24 #include <ns3/spectrum-error-model.h>
25 #include <ns3/log.h>
26 #include <ns3/test.h>
27 #include <ns3/simulator.h>
28 #include <ns3/packet.h>
29 #include <ns3/ptr.h>
30 #include <iostream>
31 #include "ns3/radio-bearer-stats-calculator.h"
32 #include <ns3/constant-position-mobility-model.h>
33 #include <ns3/eps-bearer.h>
34 #include <ns3/node-container.h>
35 #include <ns3/mobility-helper.h>
36 #include <ns3/net-device-container.h>
37 #include <ns3/lte-ue-net-device.h>
38 #include <ns3/lte-enb-net-device.h>
39 #include <ns3/lte-ue-rrc.h>
40 #include <ns3/lte-helper.h>
41 #include "ns3/string.h"
42 #include "ns3/double.h"
43 #include <ns3/lte-enb-phy.h>
44 #include <ns3/lte-ue-phy.h>
45 #include <ns3/boolean.h>
46 #include <ns3/enum.h>
47 #include <ns3/config-store-module.h>
48 
49 #include "lte-test-rr-ff-mac-scheduler.h"
50 
51 NS_LOG_COMPONENT_DEFINE ("LenaTestRrFfMacScheduler");
52 
53 namespace ns3 {
54 
55 
56 LenaTestRrFfMacSchedulerSuite::LenaTestRrFfMacSchedulerSuite ()
57  : TestSuite ("lte-rr-ff-mac-scheduler", SYSTEM)
58 {
59  NS_LOG_INFO ("creating LenaRrFfMacSchedulerTestCase");
60 
61  bool errorModel = true;
62 
63 
64  // DOWNLINK- DISTANCE 0 -> MCS 28 -> Itbs 26 (from table 7.1.7.2.1-1 of 36.213)
65  // 1 user -> 24 PRB at Itbs 26 -> 2196 -> 2196000 bytes/sec
66  // 3 users -> 8 PRB at Itbs 26 -> 749 -> 749000 bytes/sec
67  // 6 users -> 4 PRB at Itbs 26 -> 373 -> 373000 bytes/sec
68  // 9 user -> 2 PRB at Itbs 26 -> 185 -> 185000 bytes/sec
69  // 12 users -> 2 PRB at Itbs 26 -> 185 -> 185000 bytes/sec
70  // 15 users -> 2 PRB at Itbs 26 * 0.8 -> 148 -> 148000 bytes/sec
71  // UPLINK- DISTANCE 0 -> MCS 28 -> Itbs 26 (from table 7.1.7.2.1-1 of 36.213)
72  // 1 user -> 25 PRB at Itbs 26 -> 2292 -> 2292000 bytes/sec
73  // 3 users -> 8 PRB at Itbs 26 -> 749 -> 749000 bytes/sec
74  // 6 users -> 4 PRB at Itbs 26 -> 373 -> 373000 bytes/sec
75  // after the patch enforcing min 3 PRBs per UE:
76  // 9 users -> 3 PRB at Itbs 26 -> 277 bytes * 8/9 UE/TTI -> 246220 bytes/sec
77  // 12 users -> 3 PRB at Itbs 26 -> 277 bytes * 8/12 UE/TTI -> 184670 bytes/sec
78  // 15 users -> 3 PRB at Itbs 26 -> 277 bytes * 8/15 UE/TTI -> 147730 bytes/sec
79  AddTestCase (new LenaRrFfMacSchedulerTestCase (1,0,0,2196000,2292000,errorModel), TestCase::EXTENSIVE);
80  AddTestCase (new LenaRrFfMacSchedulerTestCase (3,0,0,749000,749000,errorModel), TestCase::QUICK);
81  AddTestCase (new LenaRrFfMacSchedulerTestCase (6,0,0,373000,373000,errorModel), TestCase::EXTENSIVE);
82  AddTestCase (new LenaRrFfMacSchedulerTestCase (9,0,0,185000,246220,errorModel), TestCase::EXTENSIVE);
83  AddTestCase (new LenaRrFfMacSchedulerTestCase (12,0,0,185000,184670,errorModel), TestCase::EXTENSIVE);
84  AddTestCase (new LenaRrFfMacSchedulerTestCase (15,0,0,148000,147730,errorModel), TestCase::EXTENSIVE);
85 
86  // DOWNLINK - DISTANCE 4800 -> MCS 22 -> Itbs 20 (from table 7.1.7.2.1-1 of 36.213)
87  // 1 user -> 24 PRB at Itbs 20 -> 1383 -> 1383000 bytes/sec
88  // 3 users -> 8 PRB at Itbs 20 -> 469 -> 469000 bytes/sec
89  // 6 users -> 4 PRB at Itbs 20 -> 233 -> 233000 bytes/sec
90  // 9 user -> 2 PRB at Itbs 20 -> 113 -> 113000 bytes/sec
91  // 12 users -> 2 PRB at Itbs 20 -> 113 -> 113000 bytes/sec
92  // 15 users -> 2 PRB at Itbs 20 * 0.8 -> 90.4 -> 90400 bytes/sec
93  // UPLINK - DISTANCE 4800 -> MCS 14 -> Itbs 13 (from table 7.1.7.2.1-1 of 36.213)
94  // 1 user -> 25 PRB at Itbs 13 -> 807 -> 807000 bytes/sec
95  // 3 users -> 8 PRB at Itbs 13 -> 253 -> 253000 bytes/sec
96  // 6 users -> 4 PRB at Itbs 13 -> 125 -> 125000 bytes/sec
97  // after the patch enforcing min 3 PRBs per UE:
98  // 9 users -> 3 PRB at Itbs 13 -> 93 bytes * 8/9 UE/TTI -> 82667 bytes/sec
99  // 12 users -> 3 PRB at Itbs 13 -> 93 bytes * 8/12 UE/TTI -> 62000 bytes/sec
100  // 15 users -> 3 PRB at Itbs 13 -> 93 bytes * 8/15 UE/TTI -> 49600 bytes/sec
101  AddTestCase (new LenaRrFfMacSchedulerTestCase (1,0,4800,1383000,807000,errorModel), TestCase::EXTENSIVE);
102  AddTestCase (new LenaRrFfMacSchedulerTestCase (3,0,4800,469000,253000,errorModel), TestCase::EXTENSIVE);
103  AddTestCase (new LenaRrFfMacSchedulerTestCase (6,0,4800,233000,125000,errorModel), TestCase::EXTENSIVE);
104  AddTestCase (new LenaRrFfMacSchedulerTestCase (9,0,4800,113000,82667,errorModel), TestCase::EXTENSIVE);
105  AddTestCase (new LenaRrFfMacSchedulerTestCase (12,0,4800,113000,62000,errorModel), TestCase::EXTENSIVE);
106  AddTestCase (new LenaRrFfMacSchedulerTestCase (15,0,4800,90400,49600,errorModel), TestCase::EXTENSIVE);
107 
108  // DOWNLINK - DISTANCE 6000 -> MCS 14 -> Itbs 13 (from table 7.1.7.2.1-1 of 36.213)
109  // 1 user -> 24 PRB at Itbs 15 -> 775 -> 775000 bytes/sec
110  // 3 users -> 8 PRB at Itbs 15 -> 253 -> 253000 bytes/sec
111  // 6 users -> 4 PRB at Itbs 15 -> 125 -> 125000 bytes/sec
112  // 9 user -> 2 PRB at Itbs 15 -> 61 -> 61000 bytes/sec
113  // 12 users -> 2 PRB at Itbs 15 -> 61 -> 61000 bytes/sec
114  // 15 users -> 2 PRB at Itbs 15 * 0.8 -> 48.8 -> 48800 bytes/sec
115  // UPLINK - DISTANCE 6000 -> MCS 12 -> Itbs 11 (from table 7.1.7.2.1-1 of 36.213)
116  // 1 user -> 25 PRB at Itbs 11 -> 621 -> 621000 bytes/sec
117  // 3 users -> 8 PRB at Itbs 11 -> 201 -> 201000 bytes/sec
118  // 6 users -> 4 PRB at Itbs 11 -> 97 -> 97000 bytes/sec
119  // 9 users -> 3 PRB at Itbs 11 -> 73 bytes * 8/9 UE/TTI -> 64889 bytes/sec
120  // 12 users -> 3 PRB at Itbs 11 -> 73 bytes * 8/12 UE/TTI -> 48667 bytes/sec
121  // 15 users -> 3 PRB at Itbs 11 -> 73 bytes * 8/15 UE/TTI -> 38993 bytes/sec
122  AddTestCase (new LenaRrFfMacSchedulerTestCase (1,0,6000,775000,621000,errorModel), TestCase::EXTENSIVE);
123  AddTestCase (new LenaRrFfMacSchedulerTestCase (3,0,6000,253000,201000,errorModel), TestCase::EXTENSIVE);
124  AddTestCase (new LenaRrFfMacSchedulerTestCase (6,0,6000,125000,97000,errorModel), TestCase::EXTENSIVE);
125  AddTestCase (new LenaRrFfMacSchedulerTestCase (9,0,6000,61000,64889,errorModel), TestCase::EXTENSIVE);
126  AddTestCase (new LenaRrFfMacSchedulerTestCase (12,0,6000,61000,48667,errorModel), TestCase::EXTENSIVE);
127  AddTestCase (new LenaRrFfMacSchedulerTestCase (15,0,6000,48800,38993,errorModel), TestCase::EXTENSIVE);
128 
129  // DOWNLINK - DISTANCE 10000 -> MCS 8 -> Itbs 8 (from table 7.1.7.2.1-1 of 36.213)
130  // 1 user -> 24 PRB at Itbs 8 -> 437 -> 437000 bytes/sec
131  // 3 users -> 8 PRB at Itbs 8 -> 137 -> 137000 bytes/sec
132  // 6 users -> 4 PRB at Itbs 8 -> 67 -> 67000 bytes/sec
133  // 9 user -> 2 PRB at Itbs 8 -> 32 -> 32000 bytes/sec
134  // 12 users -> 2 PRB at Itbs 8 -> 32 -> 32000 bytes/sec
135  // 15 users -> 2 PRB at Itbs 8 * 0.8 -> 25.6 -> 25600 bytes/sec
136  // UPLINK - DISTANCE 9000 -> MCS 8 -> Itbs 8 (from table 7.1.7.2.1-1 of 36.213)
137  // 1 user -> 24 PRB at Itbs 8 -> 437 -> 437000 bytes/sec
138  // 3 users -> 8 PRB at Itbs 8 -> 137 -> 137000 bytes/sec
139  // 6 users -> 4 PRB at Itbs 8 -> 67 -> 67000 bytes/sec
140  // after the patch enforcing min 3 PRBs per UE:
141  // 9 users -> 3 PRB at Itbs 8 -> 49 bytes * 8/9 UE/TTI -> 43556 bytes/sec
142  // 12 users -> 3 PRB at Itbs 8 -> 49 bytes * 8/12 UE/TTI -> 32667 bytes/sec
143  // 15 users -> 3 PRB at Itbs 8 -> 49 bytes * 8/15 UE/TTI -> 26133 bytes/sec
144  AddTestCase (new LenaRrFfMacSchedulerTestCase (1,0,10000,437000,437000,errorModel), TestCase::EXTENSIVE);
145  AddTestCase (new LenaRrFfMacSchedulerTestCase (3,0,10000,137000,137000,errorModel), TestCase::EXTENSIVE);
146  AddTestCase (new LenaRrFfMacSchedulerTestCase (6,0,10000,67000,67000,errorModel), TestCase::EXTENSIVE);
147  AddTestCase (new LenaRrFfMacSchedulerTestCase (9,0,10000,32000,43556,errorModel), TestCase::EXTENSIVE);
148  AddTestCase (new LenaRrFfMacSchedulerTestCase (12,0,10000,32000,32667,errorModel), TestCase::EXTENSIVE);
149  AddTestCase (new LenaRrFfMacSchedulerTestCase (15,0,10000,25600,26133,errorModel), TestCase::EXTENSIVE);
150 
151  // DOWNLINK - DISTANCE 20000 -> MCS 8 -> Itbs 8 (from table 7.1.7.2.1-1 of 36.213)
152  // 1 user -> 24 PRB at Itbs 8 -> 421 -> 421000 bytes/sec
153  // 3 users -> 8 PRB at Itbs 8 -> 137 -> 137000 bytes/sec
154  // 6 users -> 4 PRB at Itbs 8 -> 67 -> 67000 bytes/sec
155  // 9 user -> 2 PRB at Itbs 8 -> 32 -> 32000 bytes/sec
156  // 12 users -> 2 PRB at Itbs 8 -> 32 -> 32000 bytes/sec
157  // 15 users -> 2 PRB at Itbs 8 * 0.8 -> 25.6 -> 25600 bytes/sec
158  // UPLINK - DISTANCE 20000 -> MCS 2 -> Itbs 2 (from table 7.1.7.2.1-1 of 36.213)
159  // 1 user -> 25 PRB at Itbs 2 -> 137 -> 137000 bytes/sec
160  // 3 users -> 8 PRB at Itbs 2 -> 41 -> 41000 bytes/sec
161  // 6 users -> 4 PRB at Itbs 2 -> 22 -> 22000 bytes/sec
162  // after the patch enforcing min 3 PRBs per UE:
163  // 9 users -> 3 PRB at Itbs 2 -> 18 bytes * 8/9 UE/TTI -> 16000 bytes/sec
164  // 12 users -> 3 PRB at Itbs 2 -> 18 bytes * 8/12 UE/TTI -> 12000 bytes/sec
165  // 15 users -> 3 PRB at Itbs 2 -> 18 bytes * 8/15 UE/TTI -> 9600 bytes/sec
166  AddTestCase (new LenaRrFfMacSchedulerTestCase (1,0,20000,421000,137000,errorModel), TestCase::EXTENSIVE);
167  AddTestCase (new LenaRrFfMacSchedulerTestCase (3,0,20000,137000,41000,errorModel), TestCase::EXTENSIVE);
168  AddTestCase (new LenaRrFfMacSchedulerTestCase (6,0,20000,67000,22000,errorModel), TestCase::EXTENSIVE);
169  AddTestCase (new LenaRrFfMacSchedulerTestCase (9,0,20000,32000,16000,errorModel), TestCase::EXTENSIVE);
170  AddTestCase (new LenaRrFfMacSchedulerTestCase (12,0,20000,32000,12000,errorModel), TestCase::EXTENSIVE);
171  AddTestCase (new LenaRrFfMacSchedulerTestCase (15,0,20000,25600,9600,errorModel), TestCase::EXTENSIVE);
172 
173 }
174 
175 static LenaTestRrFfMacSchedulerSuite lenaTestRrFfMacSchedulerSuite;
176 
177 std::string
178 LenaRrFfMacSchedulerTestCase::BuildNameString (uint16_t nUser, uint16_t dist)
179 {
180  std::ostringstream oss;
181  oss << nUser << " UEs, distance " << dist << " m";
182  return oss.str ();
183 }
184 
185 LenaRrFfMacSchedulerTestCase::LenaRrFfMacSchedulerTestCase (uint16_t nUser, uint16_t nLc, uint16_t dist, double thrRefDl, double thrRefUl, bool errorModelEnabled)
186  : TestCase (BuildNameString (nUser, dist)),
187  m_nUser (nUser),
188  m_nLc (nLc),
189  m_dist (dist),
190  m_thrRefDl (thrRefDl),
191  m_thrRefUl (thrRefUl),
192  m_errorModelEnabled (errorModelEnabled)
193 {
194 }
195 
196 LenaRrFfMacSchedulerTestCase::~LenaRrFfMacSchedulerTestCase ()
197 {
198 }
199 
200 void
201 LenaRrFfMacSchedulerTestCase::DoRun (void)
202 {
203  NS_LOG_FUNCTION (this << m_nUser << m_nLc << m_dist);
204  if (!m_errorModelEnabled)
205  {
206  Config::SetDefault ("ns3::LteSpectrumPhy::CtrlErrorModelEnabled", BooleanValue (false));
207  Config::SetDefault ("ns3::LteSpectrumPhy::DataErrorModelEnabled", BooleanValue (false));
208  }
209  Config::SetDefault ("ns3::LteHelper::UseIdealRrc", BooleanValue (false));
210  LogComponentDisableAll (LOG_LEVEL_ALL);
211  //LogComponentEnable ("LenaTestRrFfMacCheduler", LOG_LEVEL_ALL);
212 
217  Ptr<LteHelper> lteHelper = CreateObject<LteHelper> ();
218 
219  lteHelper->SetAttribute ("PathlossModel", StringValue ("ns3::FriisSpectrumPropagationLossModel"));
220 
221  // Create Nodes: eNodeB and UE
222  NodeContainer enbNodes;
223  NodeContainer ueNodes;
224  enbNodes.Create (1);
225  ueNodes.Create (m_nUser);
226 
227  // Install Mobility Model
228  MobilityHelper mobility;
229  mobility.SetMobilityModel ("ns3::ConstantPositionMobilityModel");
230  mobility.Install (enbNodes);
231  mobility.SetMobilityModel ("ns3::ConstantPositionMobilityModel");
232  mobility.Install (ueNodes);
233 
234  // Create Devices and install them in the Nodes (eNB and UE)
235  NetDeviceContainer enbDevs;
236  NetDeviceContainer ueDevs;
237  lteHelper->SetSchedulerType ("ns3::RrFfMacScheduler");
238  enbDevs = lteHelper->InstallEnbDevice (enbNodes);
239  ueDevs = lteHelper->InstallUeDevice (ueNodes);
240 
241  // Attach a UE to a eNB
242  lteHelper->Attach (ueDevs, enbDevs.Get (0));
243 
244  // Activate an EPS bearer
245  enum EpsBearer::Qci q = EpsBearer::GBR_CONV_VOICE;
246  EpsBearer bearer (q);
247  lteHelper->ActivateDataRadioBearer (ueDevs, bearer);
248 
249 
250  Ptr<LteEnbNetDevice> lteEnbDev = enbDevs.Get (0)->GetObject<LteEnbNetDevice> ();
251  Ptr<LteEnbPhy> enbPhy = lteEnbDev->GetPhy ();
252  enbPhy->SetAttribute ("TxPower", DoubleValue (30.0));
253  enbPhy->SetAttribute ("NoiseFigure", DoubleValue (5.0));
254 
255  // Set UEs' position and power
256  for (int i = 0; i < m_nUser; i++)
257  {
258  Ptr<ConstantPositionMobilityModel> mm = ueNodes.Get (i)->GetObject<ConstantPositionMobilityModel> ();
259  mm->SetPosition (Vector (m_dist, 0.0, 0.0));
260  Ptr<LteUeNetDevice> lteUeDev = ueDevs.Get (i)->GetObject<LteUeNetDevice> ();
261  Ptr<LteUePhy> uePhy = lteUeDev->GetPhy ();
262  uePhy->SetAttribute ("TxPower", DoubleValue (23.0));
263  uePhy->SetAttribute ("NoiseFigure", DoubleValue (9.0));
264  }
265 
266 
267  double statsStartTime = 0.300; // need to allow for RRC connection establishment + SRS
268  double statsDuration = 0.4;
269  double tolerance = 0.1;
270  Simulator::Stop (Seconds (statsStartTime + statsDuration - 0.0001));
271 
272  lteHelper->EnableRlcTraces ();
273  Ptr<RadioBearerStatsCalculator> rlcStats = lteHelper->GetRlcStats ();
274  rlcStats->SetAttribute ("StartTime", TimeValue (Seconds (statsStartTime)));
275  rlcStats->SetAttribute ("EpochDuration", TimeValue (Seconds (statsDuration)));
276 
277  Simulator::Run ();
278 
282  NS_LOG_INFO ("DL - Test with " << m_nUser << " user(s) at distance " << m_dist);
283  std::vector <uint64_t> dlDataRxed;
284  if (m_errorModelEnabled)
285  {
286  m_thrRefDl *= 0.95; // for couting the Vienna AMC behavior: BLER between 0% and 10%
287  }
288  for (int i = 0; i < m_nUser; i++)
289  {
290  // get the imsi
291  uint64_t imsi = ueDevs.Get (i)->GetObject<LteUeNetDevice> ()->GetImsi ();
292  uint8_t lcId = 3;
293  dlDataRxed.push_back (rlcStats->GetDlRxData (imsi, lcId));
294  NS_LOG_INFO ("\tUser " << i << " imsi " << imsi << " lcid " << (uint16_t) lcId << " bytes rxed " << (double)dlDataRxed.at (i) << " thr " << (double)dlDataRxed.at (i) / statsDuration << " ref " << m_thrRefDl);
295  NS_TEST_ASSERT_MSG_EQ_TOL ((double)dlDataRxed.at (i) / statsDuration, m_thrRefDl, m_thrRefDl * tolerance, " Unfair Throughput!");
296  }
297 
298  NS_LOG_INFO ("UL - Test with " << m_nUser << " user(s) at distance " << m_dist);
299  std::vector <uint64_t> ulDataRxed;
300  if (m_errorModelEnabled)
301  {
302  m_thrRefUl *= 0.95; // for couting the Vienna AMC behavior: BLER between 0% and 10%
303  }
304  for (int i = 0; i < m_nUser; i++)
305  {
306  // get the imsi
307  uint64_t imsi = ueDevs.Get (i)->GetObject<LteUeNetDevice> ()->GetImsi ();
308  // get the lcId
309  uint8_t lcId = 3;
310  ulDataRxed.push_back (rlcStats->GetUlRxData (imsi, lcId));
311  NS_LOG_INFO ("\tUser " << i << " imsi " << imsi << " lcid " << (uint16_t) lcId << " bytes rxed " << (double)ulDataRxed.at (i) << " thr " << (double)ulDataRxed.at (i) / statsDuration << " ref " << m_thrRefUl << " txed " << rlcStats->GetUlTxData (imsi, lcId) / statsDuration);
312  NS_TEST_ASSERT_MSG_EQ_TOL ((double)ulDataRxed.at (i) / statsDuration, m_thrRefUl, m_thrRefUl * tolerance, " Unfair Throughput!");
313  }
314 
315  Simulator::Destroy ();
316 }
317 
318 
319 } // namespace ns3
320