A Discrete-Event Network Simulator
API
lte-test-fdmt-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 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  * Dizhi Zhou <dizhi.zhou@gmail.com>
21  */
22 
23 #include <iostream>
24 #include <sstream>
25 #include <string>
26 #include <ns3/object.h>
27 #include <ns3/spectrum-interference.h>
28 #include <ns3/spectrum-error-model.h>
29 #include <ns3/log.h>
30 #include <ns3/test.h>
31 #include <ns3/simulator.h>
32 #include <ns3/packet.h>
33 #include <ns3/ptr.h>
34 #include "ns3/radio-bearer-stats-calculator.h"
35 #include <ns3/constant-position-mobility-model.h>
37 #include <ns3/eps-bearer.h>
38 #include <ns3/node-container.h>
39 #include <ns3/mobility-helper.h>
40 #include <ns3/net-device-container.h>
41 #include <ns3/lte-ue-net-device.h>
42 #include <ns3/lte-enb-net-device.h>
43 #include <ns3/lte-ue-rrc.h>
44 #include <ns3/lte-helper.h>
45 #include "ns3/string.h"
46 #include "ns3/double.h"
47 #include <ns3/lte-enb-phy.h>
48 #include <ns3/lte-ue-phy.h>
49 #include <ns3/boolean.h>
50 #include <ns3/enum.h>
51 
52 using namespace ns3;
53 
54 NS_LOG_COMPONENT_DEFINE ("LenaTestFdMtFfMacScheduler");
55 
57  : TestSuite ("lte-fdmt-ff-mac-scheduler", SYSTEM)
58 {
59  NS_LOG_INFO ("creating LenaTestFdMtFfMacSchedulerSuite");
60 
61  bool errorModel = false;
62 
63  //Test Case : AMC works in FDMT
64 
65  //Note: here the MCS is calculated by the narrowband CQI
66 
67  // DOWNLINK - DISTANCE 0 -> MCS 28 -> Itbs 26 (from table 7.1.7.2.1-1 of 36.213)
68  // 1 user -> 24 PRB at Itbs 26 -> 2196 -> 2196000 bytes/sec for one UE; 0 bytes/sec for other UEs
69  // 3 users -> 2196000 among 3 users -> 2196000 bytes/sec for one UE; 0 bytes/sec for other UEs
70  // 6 users -> 2196000 among 6 users -> 2196000 bytes/sec for one UE; 0 bytes/sec for other UEs
71  // 12 users -> 2196000 among 12 users -> 2196000 bytes/sec for one UE; 0 bytes/sec for other UEs
72  // UPLINK- DISTANCE 0 -> MCS 28 -> Itbs 26 (from table 7.1.7.2.1-1 of 36.213)
73  // 1 user -> 25 PRB at Itbs 26 -> 2292 -> 2292000 bytes/sec
74  // 3 users -> 8 PRB at Itbs 26 -> 749 -> 749000 bytes/sec
75  // 6 users -> 4 PRB at Itbs 26 -> 373 -> 373000 bytes/sec
76  // after the patch enforcing min 3 PRBs per UE:
77  // 12 users -> 3 PRB at Itbs 26 -> 277 bytes * 8/12 UE/TTI -> 184670 bytes/sec
78  AddTestCase (new LenaFdMtFfMacSchedulerTestCase (1,0,2196000,2292000, errorModel), TestCase::EXTENSIVE);
79  AddTestCase (new LenaFdMtFfMacSchedulerTestCase (3,0,2196000,749000,errorModel), TestCase::QUICK);
80  AddTestCase (new LenaFdMtFfMacSchedulerTestCase (6,0,2196000,373000, errorModel), TestCase::EXTENSIVE);
81  AddTestCase (new LenaFdMtFfMacSchedulerTestCase (12,0,2196000,184670, errorModel), TestCase::EXTENSIVE);
82 
83  // DOWNLINK - DISTANCE 4800 -> MCS 22 -> Itbs 20 (from table 7.1.7.2.1-1 of 36.213)
84  // 1 user -> 24 PRB at Itbs 20 -> 1383 -> 1383000 byte/secfor one UE; 0 bytes/sec for other UEs
85  // 3 users -> 1383000 among 3 users -> 1383000 bytes/sec for one UE; 0 bytes/sec for other UEs
86  // 6 users -> 1383000 among 6 users -> 1383000 bytes/sec for one UE; 0 bytes/sec for other UEs
87  // 12 users -> 1383000 among 12 users -> 1383000 bytes/sec for one UE; 0 bytes/sec for other UEs
88  // UPLINK - DISTANCE 4800 -> MCS 14 -> Itbs 13 (from table 7.1.7.2.1-1 of 36.213)
89  // 1 user -> 25 PRB at Itbs 13 -> 807 -> 807000 bytes/sec
90  // 3 users -> 8 PRB at Itbs 13 -> 253 -> 253000 bytes/sec
91  // 6 users -> 4 PRB at Itbs 13 -> 125 -> 125000 bytes/sec
92  // after the patch enforcing min 3 PRBs per UE:
93  // 12 users -> 3 PRB at Itbs 13 -> 93 bytes * 8/12 UE/TTI -> 62000 bytes/sec
94  AddTestCase (new LenaFdMtFfMacSchedulerTestCase (1,4800,1383000,807000,errorModel), TestCase::EXTENSIVE);
95  AddTestCase (new LenaFdMtFfMacSchedulerTestCase (3,4800,1383000,253000,errorModel), TestCase::EXTENSIVE);
96  AddTestCase (new LenaFdMtFfMacSchedulerTestCase (6,4800,1383000,125000,errorModel), TestCase::EXTENSIVE);
97  AddTestCase (new LenaFdMtFfMacSchedulerTestCase (12,4800,1383000,62000,errorModel), TestCase::EXTENSIVE);
98 
99 
100  // DOWNLINK - DISTANCE 6000 -> MCS 20 -> Itbs 18 (from table 7.1.7.2.1-1 of 36.213)
101  // 1 user -> 24 PRB at Itbs 18 -> 1191 -> 1191000 byte/sec for one UE; 0 bytes/sec for other UEs
102  // 3 users -> 1191000 among 3 users -> 1191000 bytes/sec for one UE; 0 bytes/sec for other UEs
103  // 6 users -> 1191000 among 6 users -> 1191000 bytes/sec for one UE; 0 bytes/sec for other UEs
104  // 12 users ->1191000 among 12 users -> 1191000 bytes/sec for one UE; 0 bytes/sec for other UEs
105  // UPLINK - DISTANCE 6000 -> MCS 12 -> Itbs 11 (from table 7.1.7.2.1-1 of 36.213)
106  // 1 user -> 25 PRB at Itbs 11 -> 621 -> 621000 bytes/sec
107  // 3 users -> 8 PRB at Itbs 11 -> 201 -> 201000 bytes/sec
108  // 6 users -> 4 PRB at Itbs 11 -> 97 -> 97000 bytes/sec
109  // after the patch enforcing min 3 PRBs per UE:
110  // 12 users -> 3 PRB at Itbs 11 -> 73 bytes * 8/12 UE/TTI -> 48667 bytes/sec
111  AddTestCase (new LenaFdMtFfMacSchedulerTestCase (1,6000,1191000,621000, errorModel), TestCase::EXTENSIVE);
112  AddTestCase (new LenaFdMtFfMacSchedulerTestCase (3,6000,1191000,201000, errorModel), TestCase::EXTENSIVE);
113  AddTestCase (new LenaFdMtFfMacSchedulerTestCase (6,6000,1191000,97000, errorModel), TestCase::EXTENSIVE);
114  AddTestCase (new LenaFdMtFfMacSchedulerTestCase (12,6000,1191000,48667, errorModel), TestCase::EXTENSIVE);
115 
116  // DOWNLINK - DISTANCE 10000 -> MCS 14 -> Itbs 13 (from table 7.1.7.2.1-1 of 36.213)
117  // 1 user -> 24 PRB at Itbs 13 -> 775 -> 775000 byte/sec for one UE; 0 bytes/sec for other UEs
118  // 3 users -> 775000 among 3 users -> 775000 bytes/sec for one UE; 0 bytes/sec for other UEs
119  // 6 users -> 775000 among 6 users -> 775000 bytes/sec for one UE; 0 bytes/sec for other UEs
120  // 12 users -> 775000 among 12 users -> 775000 bytes/sec for one UE; 0 bytes/sec for other UEs
121  // UPLINK - DISTANCE 10000 -> MCS 8 -> Itbs 8 (from table 7.1.7.2.1-1 of 36.213)
122  // 1 user -> 24 PRB at Itbs 8 -> 437 -> 437000 bytes/sec
123  // 3 users -> 8 PRB at Itbs 8 -> 137 -> 137000 bytes/sec
124  // 6 users -> 4 PRB at Itbs 8 -> 67 -> 67000 bytes/sec
125  // after the patch enforcing min 3 PRBs per UE:
126  // 12 users -> 3 PRB at Itbs 8 -> 49 bytes * 8/12 UE/TTI -> 32667 bytes/sec
127  AddTestCase (new LenaFdMtFfMacSchedulerTestCase (1,10000,775000,437000,errorModel), TestCase::EXTENSIVE);
128  AddTestCase (new LenaFdMtFfMacSchedulerTestCase (3,10000,775000,137000,errorModel), TestCase::EXTENSIVE);
129  AddTestCase (new LenaFdMtFfMacSchedulerTestCase (6,10000,775000,67000,errorModel), TestCase::EXTENSIVE);
130  AddTestCase (new LenaFdMtFfMacSchedulerTestCase (12,10000,775000,32667,errorModel), TestCase::EXTENSIVE);
131 
132  // DONWLINK - DISTANCE 20000 -> MCS 8 -> Itbs 8 (from table 7.1.7.2.1-1 of 36.213)
133  // 1 user -> 24 PRB at Itbs 8 -> 421 -> 421000 bytes/sec for one UE; 0 bytes/sec for other UEs
134  // 3 users -> 421000 among 3 users -> 421000 bytes/sec for one UE; 0 bytes/sec for other UEs
135  // 6 users -> 421000 among 6 users -> 421000 bytes/sec for one UE; 0 bytes/sec for other UEs
136  // 12 users -> 421000 among 12 users -> 421000 bytes/sec for one UE; 0 bytes/sec for other UEs
137  // UPLINK - DISTANCE 20000 -> MCS 2 -> Itbs 2 (from table 7.1.7.2.1-1 of 36.213)
138  // 1 user -> 25 PRB at Itbs 2 -> 233 -> 137000 bytes/sec
139  // 3 users -> 8 PRB at Itbs 2 -> 69 -> 41000 bytes/sec
140  // 6 users -> 4 PRB at Itbs 2 -> 32 -> 22000 bytes/sec
141  // after the patch enforcing min 3 PRBs per UE:
142  // 12 users -> 3 PRB at Itbs 2 -> 26 bytes * 8/12 UE/TTI -> 12000 bytes/sec
143  AddTestCase (new LenaFdMtFfMacSchedulerTestCase (1,20000,421000,137000,errorModel), TestCase::EXTENSIVE);
144  AddTestCase (new LenaFdMtFfMacSchedulerTestCase (3,20000,421000,41000,errorModel), TestCase::EXTENSIVE);
145  AddTestCase (new LenaFdMtFfMacSchedulerTestCase (6,20000,421000,22000,errorModel), TestCase::EXTENSIVE);
146  AddTestCase (new LenaFdMtFfMacSchedulerTestCase (12,20000,421000,12000,errorModel), TestCase::EXTENSIVE);
147 
148  // DOWNLINK - DISTANCE 100000 -> CQI == 0 -> out of range -> 0 bytes/sec
149  // UPLINK - DISTANCE 100000 -> CQI == 0 -> out of range -> 0 bytes/sec
150  AddTestCase (new LenaFdMtFfMacSchedulerTestCase (1,100000,0,0,errorModel), TestCase::QUICK);
151 }
152 
154 
155 
156 // --------------- T E S T - C A S E ------------------------------
157 
158 std::string
160 {
161  std::ostringstream oss;
162  oss << nUser << " UEs, distance " << dist << " m";
163  return oss.str ();
164 }
165 
166 LenaFdMtFfMacSchedulerTestCase::LenaFdMtFfMacSchedulerTestCase (uint16_t nUser, double dist, double thrRefDl, double thrRefUl, bool errorModelEnabled)
167  : TestCase (BuildNameString (nUser, dist)),
168  m_nUser (nUser),
169  m_dist (dist),
170  m_thrRefDl (thrRefDl),
171  m_thrRefUl (thrRefUl),
172  m_errorModelEnabled (errorModelEnabled)
173 {
174 }
175 
177 {
178 }
179 
180 
181 void
183 {
184 
185  NS_LOG_FUNCTION (this << m_nUser << m_dist);
186 
187  if (!m_errorModelEnabled)
188  {
189  Config::SetDefault ("ns3::LteSpectrumPhy::CtrlErrorModelEnabled", BooleanValue (false));
190  Config::SetDefault ("ns3::LteSpectrumPhy::DataErrorModelEnabled", BooleanValue (false));
191  }
192 
193  Config::SetDefault ("ns3::LteHelper::UseIdealRrc", BooleanValue (true));
194 
195  //Disable Uplink Power Control
196  Config::SetDefault ("ns3::LteUePhy::EnableUplinkPowerControl", BooleanValue (false));
197 
202  Ptr<LteHelper> lteHelper = CreateObject<LteHelper> ();
203  lteHelper->SetAttribute ("PathlossModel", StringValue ("ns3::FriisSpectrumPropagationLossModel"));
204 
205  // Create Nodes: eNodeB and UE
206  NodeContainer enbNodes;
207  NodeContainer ueNodes;
208  enbNodes.Create (1);
209  ueNodes.Create (m_nUser);
210 
211  // Install Mobility Model
213  mobility.SetMobilityModel ("ns3::ConstantPositionMobilityModel");
214  mobility.Install (enbNodes);
215  mobility.SetMobilityModel ("ns3::ConstantPositionMobilityModel");
216  mobility.Install (ueNodes);
217 
218  // Create Devices and install them in the Nodes (eNB and UE)
219  NetDeviceContainer enbDevs;
220  NetDeviceContainer ueDevs;
221  lteHelper->SetSchedulerType ("ns3::FdMtFfMacScheduler");
222  enbDevs = lteHelper->InstallEnbDevice (enbNodes);
223  ueDevs = lteHelper->InstallUeDevice (ueNodes);
224 
225  // Attach a UE to a eNB
226  lteHelper->Attach (ueDevs, enbDevs.Get (0));
227 
228  // Activate an EPS bearer
229  enum EpsBearer::Qci q = EpsBearer::GBR_CONV_VOICE;
230  EpsBearer bearer (q);
231  lteHelper->ActivateDataRadioBearer (ueDevs, bearer);
232 
233 
234  Ptr<LteEnbNetDevice> lteEnbDev = enbDevs.Get (0)->GetObject<LteEnbNetDevice> ();
235  Ptr<LteEnbPhy> enbPhy = lteEnbDev->GetPhy ();
236  enbPhy->SetAttribute ("TxPower", DoubleValue (30.0));
237  enbPhy->SetAttribute ("NoiseFigure", DoubleValue (5.0));
238 
239  // Set UEs' position and power
240  for (int i = 0; i < m_nUser; i++)
241  {
243  mm->SetPosition (Vector (m_dist, 0.0, 0.0));
244  Ptr<LteUeNetDevice> lteUeDev = ueDevs.Get (i)->GetObject<LteUeNetDevice> ();
245  Ptr<LteUePhy> uePhy = lteUeDev->GetPhy ();
246  uePhy->SetAttribute ("TxPower", DoubleValue (23.0));
247  uePhy->SetAttribute ("NoiseFigure", DoubleValue (9.0));
248  }
249 
250 
251  double statsStartTime = 0.300; // need to allow for RRC connection establishment + SRS
252  double statsDuration = 0.6;
253  double tolerance = 0.1;
254  Simulator::Stop (Seconds (statsStartTime + statsDuration - 0.000001));
255 
256  lteHelper->EnableMacTraces ();
257  lteHelper->EnableRlcTraces ();
258  Ptr<RadioBearerStatsCalculator> rlcStats = lteHelper->GetRlcStats ();
259  rlcStats->SetAttribute ("StartTime", TimeValue (Seconds (statsStartTime)));
260  rlcStats->SetAttribute ("EpochDuration", TimeValue (Seconds (statsDuration)));
261 
262 
263  Simulator::Run ();
264 
268  NS_LOG_INFO ("DL - Test with " << m_nUser << " user(s) at distance " << m_dist);
269  std::vector <uint64_t> dlDataRxed;
270  for (int i = 0; i < m_nUser; i++)
271  {
272  // get the imsi
273  uint64_t imsi = ueDevs.Get (i)->GetObject<LteUeNetDevice> ()->GetImsi ();
274  uint8_t lcId = 3;
275  dlDataRxed.push_back (rlcStats->GetDlRxData (imsi, lcId));
276  NS_LOG_INFO ("\tUser " << i << " imsi " << imsi << " bytes rxed " << (double)dlDataRxed.at (i) << " thr " << (double)dlDataRxed.at (i) / statsDuration << " ref " << m_thrRefDl);
277  }
278 
284  uint8_t found = 0;
285  for (int i = 0; i < m_nUser; i++)
286  {
287  double throughput = (double)dlDataRxed.at (i) / statsDuration;
288  if (throughput != 0 && found == 0)
289  {
290  NS_TEST_ASSERT_MSG_EQ_TOL (throughput, m_thrRefDl, m_thrRefDl * tolerance, " Unfair Throughput!");
291  found = 1;
292  }
293  else if (throughput != 0 && found == 1)
294  {
295  NS_TEST_ASSERT_MSG_EQ_TOL (0, m_thrRefDl, m_thrRefDl * tolerance, " Unfair Throughput!");
296  }
297  else
298  NS_TEST_ASSERT_MSG_EQ_TOL (throughput, 0, 0, " Unfair Throughput!");
299  }
300 
304  NS_LOG_INFO ("UL - Test with " << m_nUser << " user(s) at distance " << m_dist);
305  std::vector <uint64_t> ulDataRxed;
306  for (int i = 0; i < m_nUser; i++)
307  {
308  // get the imsi
309  uint64_t imsi = ueDevs.Get (i)->GetObject<LteUeNetDevice> ()->GetImsi ();
310  // get the lcId
311  uint8_t lcId = 3;
312  ulDataRxed.push_back (rlcStats->GetUlRxData (imsi, lcId));
313  NS_LOG_INFO ("\tUser " << i << " imsi " << imsi << " bytes rxed " << (double)ulDataRxed.at (i) << " thr " << (double)ulDataRxed.at (i) / statsDuration << " ref " << m_thrRefUl);
314  }
321  for (int i = 0; i < m_nUser; i++)
322  {
323  NS_TEST_ASSERT_MSG_EQ_TOL ((double)ulDataRxed.at (i) / statsDuration, m_thrRefUl, m_thrRefUl * tolerance, " Unfair Throughput!");
324  }
325  Simulator::Destroy ();
326 
327 }
328 
double m_thrRefUl
UL throughput reference.
Ptr< NetDevice > Get(uint32_t i) const
Get the Ptr<NetDevice> stored in this container at a given index.
double m_thrRefDl
DL throughput reference.
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by "...
AttributeValue implementation for Boolean.
Definition: boolean.h:36
NetDeviceContainer InstallEnbDevice(NodeContainer c)
Create a set of eNodeB devices.
Definition: lte-helper.cc:474
Hold variables of type string.
Definition: string.h:41
A suite of tests to run.
Definition: test.h:1342
Mobility model for which the current position does not change once it has been set and until it is se...
void Attach(NetDeviceContainer ueDevices)
Enables automatic attachment of a set of UE devices to a suitable cell using Idle mode initial cell s...
Definition: lte-helper.cc:957
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Definition: log.h:202
void EnableRlcTraces(void)
Enable trace sinks for RLC layer.
Definition: lte-helper.cc:1431
#define NS_LOG_INFO(msg)
Use NS_LOG to output a message of level LOG_INFO.
Definition: log.h:278
encapsulates test code
Definition: test.h:1155
void ActivateDataRadioBearer(NetDeviceContainer ueDevices, EpsBearer bearer)
Activate a Data Radio Bearer on a given UE devices (for LTE-only simulation).
Definition: lte-helper.cc:1310
This system test program creates different test cases with a single eNB and several UEs...
void SetSchedulerType(std::string type)
Set the type of scheduler to be used by eNodeB devices.
Definition: lte-helper.cc:279
mobility
Definition: third.py:101
This class contains the specification of EPS Bearers.
Definition: eps-bearer.h:71
AttributeValue implementation for Time.
Definition: nstime.h:1076
void AddTestCase(TestCase *testCase, TestDuration duration=QUICK)
Add an individual child TestCase to this test suite.
Definition: test.cc:299
uint64_t GetDlRxData(uint64_t imsi, uint8_t lcid)
Gets the number of received downlink data bytes.
holds a vector of ns3::NetDevice pointers
Test suite for LenaFdMtFfMacSchedulerTestCase test case.
Ptr< LteEnbPhy > GetPhy(void) const
#define NS_TEST_ASSERT_MSG_EQ_TOL(actual, limit, tol, msg)
Test that actual and expected (limit) values are equal to plus or minus some tolerance and report and...
Definition: test.h:380
Ptr< T > GetObject(void) const
Get a pointer to the requested aggregated Object.
Definition: object.h:459
Every class exported by the ns3 library is enclosed in the ns3 namespace.
keep track of a set of node pointers.
virtual void DoRun(void)
Implementation to actually run this TestCase.
Ptr< LteUePhy > GetPhy(void) const
Get the Phy.
void SetPosition(const Vector &position)
Ptr< RadioBearerStatsCalculator > GetRlcStats(void)
Definition: lte-helper.cc:1568
NetDeviceContainer InstallUeDevice(NodeContainer c)
Create a set of UE devices.
Definition: lte-helper.cc:489
Helper class used to assign positions and mobility models to nodes.
uint64_t GetUlRxData(uint64_t imsi, uint8_t lcid)
Gets the number of received uplink data bytes.
static LenaTestFdMtFfMacSchedulerSuite lenaTestFdMtFfMacSchedulerSuite
Time Seconds(double value)
Construct a Time in the indicated unit.
Definition: nstime.h:1014
LenaFdMtFfMacSchedulerTestCase(uint16_t nUser, double dist, double thrRefDl, double thrRefUl, bool errorModelEnabled)
Constructor.
void SetDefault(std::string name, const AttributeValue &value)
Definition: config.cc:782
Ptr< Node > Get(uint32_t i) const
Get the Ptr<Node> stored in this container at a given index.
void Create(uint32_t n)
Create n nodes and append pointers to them to the end of this NodeContainer.
void EnableMacTraces(void)
Enable trace sinks for MAC layer.
Definition: lte-helper.cc:1525
static std::string BuildNameString(uint16_t nUser, double dist)
Builds the test name string based on provided parameter values.
double m_dist
distance between the nodes
This class can be used to hold variables of floating point type such as &#39;double&#39; or &#39;float&#39;...
Definition: double.h:41
void SetAttribute(std::string name, const AttributeValue &value)
Set a single attribute, raising fatal errors if unsuccessful.
Definition: object-base.cc:185
The eNodeB device implementation.
Qci
QoS Class Indicator.
Definition: eps-bearer.h:77
The LteUeNetDevice class implements the UE net device.