A Discrete-Event Network Simulator
API
lte-test-harq.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  */
20 
21 #include <ns3/object.h>
22 #include <ns3/spectrum-interference.h>
23 #include <ns3/spectrum-error-model.h>
24 #include <ns3/log.h>
25 #include <ns3/test.h>
26 #include <ns3/simulator.h>
27 #include <ns3/packet.h>
28 #include <ns3/ptr.h>
29 #include <iostream>
30 #include <cmath>
31 #include <ns3/radio-bearer-stats-calculator.h>
32 #include <ns3/mobility-building-info.h>
33 #include <ns3/hybrid-buildings-propagation-loss-model.h>
34 #include <ns3/eps-bearer.h>
35 #include <ns3/node-container.h>
36 #include <ns3/mobility-helper.h>
37 #include <ns3/net-device-container.h>
38 #include <ns3/lte-ue-net-device.h>
39 #include <ns3/lte-enb-net-device.h>
40 #include <ns3/lte-ue-rrc.h>
41 #include <ns3/lte-helper.h>
42 #include <ns3/string.h>
43 #include <ns3/double.h>
44 #include <ns3/lte-enb-phy.h>
45 #include <ns3/lte-ue-phy.h>
46 #include <ns3/config.h>
47 #include <ns3/boolean.h>
48 #include <ns3/enum.h>
49 #include <ns3/unused.h>
50 #include <ns3/ff-mac-scheduler.h>
51 #include <ns3/buildings-helper.h>
52 
53 #include "lte-test-harq.h"
54 
55 using namespace ns3;
56 
57 NS_LOG_COMPONENT_DEFINE ("LenaTestHarq");
58 
60  : TestSuite ("lte-harq", SYSTEM)
61 {
62  NS_LOG_INFO ("creating LenaTestHarqTestCase");
63 
64 
65  // Tests on DL/UL Data channels (PDSCH, PUSCH)
66  // MCS 0 TB size of 66 bytes SINR -9.91 dB expected throughput 31822 bytes/s
67  // TBLER 1st tx 1.0
68  // TBLER 2nd tx 0.074
69  AddTestCase (new LenaHarqTestCase (2, 2400, 66, 0.12, 31822), TestCase::QUICK);
70 
71  // Tests on DL/UL Data channels (PDSCH, PUSCH)
72  // MCS 10 TB size of 472 bytes SINR 0.3 dB expected throughput 209964 bytes/s
73  // TBLER 1st tx 1.0
74  // TBLER 2nd tx 0.248
75  AddTestCase (new LenaHarqTestCase (1, 770, 472, 0.06, 209964), TestCase::QUICK);
76 
77 
78 
79 }
80 
82 
83 std::string
84 LenaHarqTestCase::BuildNameString (uint16_t nUser, uint16_t dist, uint16_t tbSize)
85 {
86  std::ostringstream oss;
87  oss << nUser << " UEs, distance " << dist << " m, TB size " << tbSize;
88  return oss.str ();
89 }
90 
91 LenaHarqTestCase::LenaHarqTestCase (uint16_t nUser, uint16_t dist, uint16_t tbSize, double amcBer, double thrRef)
92  : TestCase (BuildNameString (nUser, dist, tbSize)),
93  m_nUser (nUser),
94  m_dist (dist),
95  m_amcBer (amcBer),
96  m_throughputRef (thrRef)
97 {
98 }
99 
101 {
102 }
103 
104 void
106 {
107 
108  Config::SetDefault ("ns3::LteAmc::Ber", DoubleValue (m_amcBer));
109  Config::SetDefault ("ns3::LteAmc::AmcModel", EnumValue (LteAmc::PiroEW2010));
110  Config::SetDefault ("ns3::LteSpectrumPhy::CtrlErrorModelEnabled", BooleanValue (false));
111  Config::SetDefault ("ns3::LteSpectrumPhy::DataErrorModelEnabled", BooleanValue (true));
112  Config::SetDefault ("ns3::LteHelper::UseIdealRrc", BooleanValue (true));
113  //Disable Uplink Power Control
114  Config::SetDefault ("ns3::LteUePhy::EnableUplinkPowerControl", BooleanValue (false));
115 
116 // Config::SetDefault ("ns3::RrFfMacScheduler::HarqEnabled", BooleanValue (false));
117 // LogComponentEnable ("LteEnbRrc", LOG_LEVEL_ALL);
118 // LogComponentEnable ("LteUeRrc", LOG_LEVEL_ALL);
119 // LogComponentEnable ("LteEnbMac", LOG_LEVEL_ALL);
120 // LogComponentEnable ("LteUeMac", LOG_LEVEL_ALL);
121 // LogComponentEnable ("LteRlc", LOG_LEVEL_ALL);
122 //
123 // LogComponentEnable ("LtePhy", LOG_LEVEL_ALL);
124 // LogComponentEnable ("LteEnbPhy", LOG_LEVEL_ALL);
125 // LogComponentEnable ("LteUePhy", LOG_LEVEL_ALL);
126 
127 // LogComponentEnable ("LteSpectrumPhy", LOG_LEVEL_ALL);
128 // LogComponentEnable ("LteInterference", LOG_LEVEL_ALL);
129 // LogComponentEnable ("LteChunkProcessor", LOG_LEVEL_ALL);
130 //
131 // LogComponentEnable ("LtePropagationLossModel", LOG_LEVEL_ALL);
132 // LogComponentEnable ("LossModel", LOG_LEVEL_ALL);
133 // LogComponentEnable ("ShadowingLossModel", LOG_LEVEL_ALL);
134 // LogComponentEnable ("PenetrationLossModel", LOG_LEVEL_ALL);
135 // LogComponentEnable ("MultipathLossModel", LOG_LEVEL_ALL);
136 // LogComponentEnable ("PathLossModel", LOG_LEVEL_ALL);
137 //
138 // LogComponentEnable ("LteNetDevice", LOG_LEVEL_ALL);
139 // LogComponentEnable ("LteUeNetDevice", LOG_LEVEL_ALL);
140 // LogComponentEnable ("LteEnbNetDevice", LOG_LEVEL_ALL);
141 
142 // LogComponentEnable ("RrFfMacScheduler", LOG_LEVEL_ALL);
143 // LogComponentEnable ("LenaHelper", LOG_LEVEL_ALL);
144 // LogComponentEnable ("RlcStatsCalculator", LOG_LEVEL_ALL);
145 
146 
147 // LogComponentEnable ("LteSpectrumPhy", LOG_LEVEL_ALL);
148 // LogComponentEnable ("LteEnbMac", LOG_LEVEL_ALL);
149 // LogComponentEnable ("LteEnbPhy", LOG_LEVEL_ALL);
150 // LogComponentEnable ("LteUePhy", LOG_LEVEL_ALL);
151 // LogComponentEnable ("RrFfMacScheduler", LOG_LEVEL_ALL);
152 // LogComponentEnable ("LenaHelper", LOG_LEVEL_ALL);
153 // LogComponentEnable ("BuildingsPropagationLossModel", LOG_LEVEL_ALL);
154 // LogComponentEnable ("LteMiErrorModel", LOG_LEVEL_ALL);
155 // LogComponentEnable ("LteAmc", LOG_LEVEL_ALL);
156 //
157 // LogComponentDisableAll (LOG_LEVEL_ALL);
158 
159 // LogComponentEnable ("LenaTestHarq", LOG_LEVEL_ALL);
160 
161 
166  Ptr<LteHelper> lena = CreateObject<LteHelper> ();
167 
168  // Create Nodes: eNodeB and UE
169  NodeContainer enbNodes;
170  NodeContainer ueNodes;
171  enbNodes.Create (1);
172  ueNodes.Create (m_nUser);
173 
174  // Install Mobility Model
176  mobility.SetMobilityModel ("ns3::ConstantPositionMobilityModel");
177  mobility.Install (enbNodes);
178  BuildingsHelper::Install (enbNodes);
179 
180  mobility.SetMobilityModel ("ns3::ConstantPositionMobilityModel");
181  mobility.Install (ueNodes);
182  BuildingsHelper::Install (ueNodes);
183 
184  // remove random shadowing component
185  lena->SetAttribute ("PathlossModel", StringValue ("ns3::HybridBuildingsPropagationLossModel"));
186  lena->SetPathlossModelAttribute ("ShadowSigmaOutdoor", DoubleValue (0.0));
187  lena->SetPathlossModelAttribute ("ShadowSigmaIndoor", DoubleValue (0.0));
188  lena->SetPathlossModelAttribute ("ShadowSigmaExtWalls", DoubleValue (0.0));
189 
190  // Create Devices and install them in the Nodes (eNB and UE)
191  NetDeviceContainer enbDevs;
192  NetDeviceContainer ueDevs;
193  lena->SetSchedulerType ("ns3::RrFfMacScheduler");
194  lena->SetSchedulerAttribute ("UlCqiFilter", EnumValue (FfMacScheduler::PUSCH_UL_CQI));
195 
196  enbDevs = lena->InstallEnbDevice (enbNodes);
197  ueDevs = lena->InstallUeDevice (ueNodes);
198 
199  // Attach a UE to a eNB
200  lena->Attach (ueDevs, enbDevs.Get (0));
201 
202  // Activate an EPS bearer
203  enum EpsBearer::Qci q = EpsBearer::GBR_CONV_VOICE;
204  EpsBearer bearer (q);
205  lena->ActivateDataRadioBearer (ueDevs, bearer);
206 
207 
208  Ptr<LteEnbNetDevice> lteEnbDev = enbDevs.Get (0)->GetObject<LteEnbNetDevice> ();
209  Ptr<LteEnbPhy> enbPhy = lteEnbDev->GetPhy ();
210  enbPhy->SetAttribute ("TxPower", DoubleValue (43.0));
211  enbPhy->SetAttribute ("NoiseFigure", DoubleValue (5.0));
212  // place the HeNB over the default rooftop level (20 mt.)
213  Ptr<MobilityModel> mm = enbNodes.Get (0)->GetObject<MobilityModel> ();
214  mm->SetPosition (Vector (0.0, 0.0, 30.0));
215 
216  // Set UEs' position and power
217  for (int i = 0; i < m_nUser; i++)
218  {
219  Ptr<MobilityModel> mm = ueNodes.Get (i)->GetObject<MobilityModel> ();
220  mm->SetPosition (Vector (m_dist, 0.0, 1.0));
221  Ptr<LteUeNetDevice> lteUeDev = ueDevs.Get (i)->GetObject<LteUeNetDevice> ();
222  Ptr<LteUePhy> uePhy = lteUeDev->GetPhy ();
223  uePhy->SetAttribute ("TxPower", DoubleValue (23.0));
224  uePhy->SetAttribute ("NoiseFigure", DoubleValue (9.0));
225  }
226 
227 
228  double statsStartTime = 0.050; // need to allow for RRC connection establishment + SRS
229  double statsDuration = 2.0;
230  Simulator::Stop (Seconds (statsStartTime + statsDuration - 0.0001));
231 
232  lena->EnableRlcTraces ();
233  Ptr<RadioBearerStatsCalculator> rlcStats = lena->GetRlcStats ();
234  rlcStats->SetAttribute ("StartTime", TimeValue (Seconds (statsStartTime)));
235  rlcStats->SetAttribute ("EpochDuration", TimeValue (Seconds (statsDuration)));
236 
237  // for debugging purposes
238  lena->EnableMacTraces ();
239 
240  Simulator::Run ();
241 
245  NS_LOG_INFO ("\tTest on downlink data shared channels (PDSCH)");
246  NS_LOG_INFO ("Test with " << m_nUser << " user(s) at distance " << m_dist << " expected Thr " << m_throughputRef);
247  for (int i = 0; i < m_nUser; i++)
248  {
249  // get the imsi
250  uint64_t imsi = ueDevs.Get (i)->GetObject<LteUeNetDevice> ()->GetImsi ();
251  uint8_t lcId = 3;
252  double txed = rlcStats->GetDlTxData (imsi, lcId);
253  double rxed = rlcStats->GetDlRxData (imsi, lcId);
254  double tolerance = 0.1;
255 
256  NS_LOG_INFO (" User " << i << " imsi " << imsi << " bytes rxed/t " << rxed/statsDuration << " txed/t " << txed/statsDuration << " thr Ref " << m_throughputRef << " Err " << (std::abs (txed/statsDuration - m_throughputRef)) / m_throughputRef);
257 
258  NS_TEST_ASSERT_MSG_EQ_TOL (txed/statsDuration, m_throughputRef, m_throughputRef * tolerance, " Unexpected Throughput!");
259  NS_TEST_ASSERT_MSG_EQ_TOL (rxed/statsDuration, m_throughputRef, m_throughputRef * tolerance, " Unexpected Throughput!");
260  }
261 
262 
263  Simulator::Destroy ();
264 }
static std::string BuildNameString(uint16_t nUser, uint16_t dist, uint16_t tbSize)
Build name string function.
Ptr< NetDevice > Get(uint32_t i) const
Get the Ptr<NetDevice> stored in this container at a given index.
void SetPathlossModelAttribute(std::string n, const AttributeValue &v)
Set an attribute for the path loss models to be created.
Definition: lte-helper.cc:393
AttributeValue implementation for Boolean.
Definition: boolean.h:36
NetDeviceContainer InstallEnbDevice(NodeContainer c)
Create a set of eNodeB devices.
Definition: lte-helper.cc:474
LenaHarqTestCase(uint16_t nUser, uint16_t dist, uint16_t tbSize, double amcBer, double thrRef)
Constructor.
Hold variables of type string.
Definition: string.h:41
A suite of tests to run.
Definition: test.h:1342
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:961
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Definition: log.h:204
void EnableRlcTraces(void)
Enable trace sinks for RLC layer.
Definition: lte-helper.cc:1435
#define NS_LOG_INFO(msg)
Use NS_LOG to output a message of level LOG_INFO.
Definition: log.h:280
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:1314
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
Keep track of the current position and velocity of an object.
double m_amcBer
AMC bit error rate.
Definition: lte-test-harq.h:69
This system test program creates different test cases with a single eNB and several UEs...
Definition: lte-test-harq.h:41
Hold variables of type enum.
Definition: enum.h:54
uint16_t m_dist
distance between nodes
Definition: lte-test-harq.h:68
AttributeValue implementation for Time.
Definition: nstime.h:1124
void AddTestCase(TestCase *testCase, TestDuration duration=QUICK)
Add an individual child TestCase to this test suite.
Definition: test.cc:299
static LenaTestHarqSuite lenaTestHarqSuite
uint64_t GetDlRxData(uint64_t imsi, uint8_t lcid)
Gets the number of received downlink data bytes.
void SetSchedulerAttribute(std::string n, const AttributeValue &v)
Set an attribute for the scheduler to be created.
Definition: lte-helper.cc:293
holds a vector of ns3::NetDevice pointers
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.
Ptr< LteUePhy > GetPhy(void) const
Get the Phy.
This class contains the specification of EPS Bearers.
Definition: eps-bearer.h:91
uint64_t GetDlTxData(uint64_t imsi, uint8_t lcid)
Gets the number of transmitted downlink data bytes.
void SetPosition(const Vector &position)
Ptr< RadioBearerStatsCalculator > GetRlcStats(void)
Definition: lte-helper.cc:1572
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.
virtual ~LenaHarqTestCase()
double m_throughputRef
throughput reference
Definition: lte-test-harq.h:70
Time Seconds(double value)
Construct a Time in the indicated unit.
Definition: nstime.h:1062
void SetDefault(std::string name, const AttributeValue &value)
Definition: config.cc:810
Ptr< Node > Get(uint32_t i) const
Get the Ptr<Node> stored in this container at a given index.
Qci
QoS Class Indicator.
Definition: eps-bearer.h:106
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:1529
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.
Test suite for harq test.
Definition: lte-test-harq.h:84
virtual void DoRun(void)
Implementation to actually run this TestCase.
uint16_t m_nUser
number of UE nodes
Definition: lte-test-harq.h:67
The LteUeNetDevice class implements the UE net device.