A Discrete-Event Network Simulator
API
lte-test-rlc-um-e2e.cc
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2012 Centre Tecnologic de Telecomunicacions de Catalunya (CTTC)
3  *
4  * This program is free software; you can redistribute it and/or modify
5  * it under the terms of the GNU General Public License version 2 as
6  * published by the Free Software Foundation;
7  *
8  * This program is distributed in the hope that it will be useful,
9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11  * GNU General Public License for more details.
12  *
13  * You should have received a copy of the GNU General Public License
14  * along with this program; if not, write to the Free Software
15  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
16  *
17  * Author: Manuel Requena <manuel.requena@cttc.es>
18  */
19 
20 #include "lte-test-rlc-um-e2e.h"
21 
22 #include "lte-simple-helper.h"
23 #include "lte-test-entities.h"
24 
25 #include "ns3/config.h"
26 #include "ns3/error-model.h"
27 #include "ns3/log.h"
28 #include "ns3/lte-rlc-header.h"
29 #include "ns3/lte-rlc-um.h"
30 #include "ns3/net-device-container.h"
31 #include "ns3/node-container.h"
32 #include "ns3/packet.h"
33 #include "ns3/pointer.h"
34 #include "ns3/radio-bearer-stats-calculator.h"
35 #include "ns3/rng-seed-manager.h"
36 #include "ns3/simulator.h"
37 
38 using namespace ns3;
39 
40 NS_LOG_COMPONENT_DEFINE("LteRlcUmE2eTest");
41 
51  : TestSuite("lte-rlc-um-e2e", SYSTEM)
52 {
53  // NS_LOG_INFO ("Creating LteRlcUmE2eTestSuite");
54 
55  double losses[] = {0.0, 0.10, 0.25, 0.50, 0.75, 0.90, 1.00};
56  uint32_t seeds[] = {1111, 2222, 3333, 4444, 5555, 6666, 7777, 8888, 9999, 10101};
57 
58  for (uint32_t l = 0; l < (sizeof(losses) / sizeof(double)); l++)
59  {
60  for (uint32_t s = 0; s < (sizeof(seeds) / sizeof(uint32_t)); s++)
61  {
62  std::ostringstream name;
63  name << " Losses = " << losses[l] << "%. Seed = " << seeds[s];
64  TestCase::TestDuration testDuration;
65  if (l == 1 && s == 0)
66  {
67  testDuration = TestCase::QUICK;
68  }
69  else
70  {
71  testDuration = TestCase::EXTENSIVE;
72  }
73  AddTestCase(new LteRlcUmE2eTestCase(name.str(), seeds[s], losses[l]), testDuration);
74  }
75  }
76 }
77 
83 
88 LteRlcUmE2eTestCase::LteRlcUmE2eTestCase(std::string name, uint32_t seed, double losses)
89  : TestCase(name)
90 {
91  // NS_LOG_UNCOND ("Creating LteRlcUmTestingTestCase: " + name);
92 
93  m_seed = seed;
94  m_losses = losses;
95 
96  m_dlDrops = 0;
97  m_ulDrops = 0;
98 }
99 
101 {
102 }
103 
104 void
106 {
107  // NS_LOG_FUNCTION (this);
108  m_dlDrops++;
109 }
110 
111 void
113 {
114  // NS_LOG_FUNCTION (this);
115  m_ulDrops++;
116 }
117 
118 void
120 {
121  uint16_t numberOfNodes = 1;
122 
123  // LogLevel level = (LogLevel) (LOG_LEVEL_ALL | LOG_PREFIX_TIME | LOG_PREFIX_NODE |
124  // LOG_PREFIX_FUNC); LogComponentEnable ("LteRlcUmE2eTest", level); LogComponentEnable
125  // ("ErrorModel", level); LogComponentEnable ("LteSimpleHelper", level); LogComponentEnable
126  // ("LteSimpleNetDevice", level); LogComponentEnable ("SimpleNetDevice", level);
127  // LogComponentEnable ("SimpleChannel", level);
128  // LogComponentEnable ("LteTestEntities", level);
129  // LogComponentEnable ("LtePdcp", level);
130  // LogComponentEnable ("LteRlc", level);
131  // LogComponentEnable ("LteRlcUm", level);
132  // LogComponentEnable ("LteRlcAm", level);
133 
134  RngSeedManager::SetSeed(m_seed);
135 
136  Ptr<LteSimpleHelper> lteSimpleHelper = CreateObject<LteSimpleHelper>();
137  // lteSimpleHelper->EnableLogComponents ();
138  // lteSimpleHelper->EnableTraces ();
139 
140  lteSimpleHelper->SetAttribute("RlcEntity", StringValue("RlcUm"));
141 
142  // eNB and UE nodes
143  NodeContainer ueNodes;
144  NodeContainer enbNodes;
145  enbNodes.Create(numberOfNodes);
146  ueNodes.Create(numberOfNodes);
147 
148  // Install LTE Devices to the nodes
149  NetDeviceContainer enbLteDevs = lteSimpleHelper->InstallEnbDevice(enbNodes);
150  NetDeviceContainer ueLteDevs = lteSimpleHelper->InstallUeDevice(ueNodes);
151 
152  // Note: Just one eNB and UE are supported. Everything is done in InstallEnbDevice and
153  // InstallUeDevice
154 
155  // Attach one UE per eNodeB
156  // for (uint16_t i = 0; i < numberOfNodes; i++)
157  // {
158  // lteSimpleHelper->Attach (ueLteDevs.Get(i), enbLteDevs.Get(i));
159  // }
160 
161  // lteSimpleHelper->ActivateEpsBearer (ueLteDevs, EpsBearer (EpsBearer::NGBR_VIDEO_TCP_DEFAULT),
162  // EpcTft::Default ());
163 
164  // Error models: downlink and uplink
165  Ptr<RateErrorModel> dlEm = CreateObject<RateErrorModel>();
166  dlEm->SetAttribute("ErrorRate", DoubleValue(m_losses));
167  dlEm->SetAttribute("ErrorUnit", StringValue("ERROR_UNIT_PACKET"));
168 
169  Ptr<RateErrorModel> ulEm = CreateObject<RateErrorModel>();
170  ulEm->SetAttribute("ErrorRate", DoubleValue(m_losses));
171  ulEm->SetAttribute("ErrorUnit", StringValue("ERROR_UNIT_PACKET"));
172 
173  // The below hooks will cause drops to be counted at simple phy layer
174  ueLteDevs.Get(0)->SetAttribute("ReceiveErrorModel", PointerValue(dlEm));
175  ueLteDevs.Get(0)->TraceConnectWithoutContext(
176  "PhyRxDrop",
178  enbLteDevs.Get(0)->SetAttribute("ReceiveErrorModel", PointerValue(ulEm));
179  enbLteDevs.Get(0)->TraceConnectWithoutContext(
180  "PhyRxDrop",
182 
183  // Sending packets from eNB RRC layer (eNB -> UE)
184  lteSimpleHelper->m_enbRrc->SetArrivalTime(Seconds(0.010));
185  lteSimpleHelper->m_enbRrc->SetPduSize(100);
186 
187  // MAC sends transmission opportunities (TxOpp)
188  lteSimpleHelper->m_enbMac->SetTxOppSize(150);
189  lteSimpleHelper->m_enbMac->SetTxOppTime(Seconds(0.005));
190  lteSimpleHelper->m_enbMac->SetTxOpportunityMode(LteTestMac::RANDOM_MODE);
191 
192  // Sending packets from UE RRC layer (UE -> eNB)
193  lteSimpleHelper->m_ueRrc->SetArrivalTime(Seconds(0.010));
194  lteSimpleHelper->m_ueRrc->SetPduSize(100);
195 
196  // MAC sends transmission opportunities (TxOpp)
197  lteSimpleHelper->m_ueMac->SetTxOppSize(150);
198  lteSimpleHelper->m_ueMac->SetTxOppTime(Seconds(0.005));
199  lteSimpleHelper->m_ueMac->SetTxOpportunityMode(LteTestMac::RANDOM_MODE);
200 
201  // Start/Stop pseudo-application at eNB RRC
202  Simulator::Schedule(Seconds(0.100), &LteTestRrc::Start, lteSimpleHelper->m_enbRrc);
203  Simulator::Schedule(Seconds(10.100), &LteTestRrc::Stop, lteSimpleHelper->m_enbRrc);
204 
205  // Start/Stop pseudo-application at UE RRC
206  Simulator::Schedule(Seconds(20.100), &LteTestRrc::Start, lteSimpleHelper->m_ueRrc);
207  Simulator::Schedule(Seconds(30.100), &LteTestRrc::Stop, lteSimpleHelper->m_ueRrc);
208 
209  Simulator::Stop(Seconds(31.000));
210  Simulator::Run();
211 
212  uint32_t txEnbRrcPdus = lteSimpleHelper->m_enbRrc->GetTxPdus();
213  uint32_t rxUeRrcPdus = lteSimpleHelper->m_ueRrc->GetRxPdus();
214 
215  uint32_t txUeRrcPdus = lteSimpleHelper->m_ueRrc->GetTxPdus();
216  uint32_t rxEnbRrcPdus = lteSimpleHelper->m_enbRrc->GetRxPdus();
217 
218  // NS_LOG_INFO ("Seed = " << m_seed);
219  // NS_LOG_INFO ("Losses (%) = " << uint32_t (m_losses * 100));
220 
221  // NS_LOG_INFO ("dl dev drops = " << m_dlDrops);
222  // NS_LOG_INFO ("ul dev drops = " << m_ulDrops);
223 
224  // NS_LOG_INFO ("eNB tx RRC count = " << txEnbRrcPdus);
225  // NS_LOG_INFO ("eNB rx RRC count = " << rxEnbRrcPdus);
226  // NS_LOG_INFO ("UE tx RRC count = " << txUeRrcPdus);
227  // NS_LOG_INFO ("UE rx RRC count = " << rxUeRrcPdus);
228 
229  NS_LOG_INFO(m_seed << "\t" << m_losses << "\t" << txEnbRrcPdus << "\t" << rxUeRrcPdus << "\t"
230  << m_dlDrops);
231  NS_LOG_INFO(m_seed << "\t" << m_losses << "\t" << txUeRrcPdus << "\t" << rxEnbRrcPdus << "\t"
232  << m_ulDrops);
233 
234  NS_TEST_ASSERT_MSG_EQ(txEnbRrcPdus,
235  rxUeRrcPdus + m_dlDrops,
236  "Downlink: TX PDUs (" << txEnbRrcPdus << ") != RX PDUs (" << rxUeRrcPdus
237  << ") + DROPS (" << m_dlDrops << ")");
238  NS_TEST_ASSERT_MSG_EQ(txUeRrcPdus,
239  rxEnbRrcPdus + m_ulDrops,
240  "Uplink: TX PDUs (" << txUeRrcPdus << ") != RX PDUs (" << rxEnbRrcPdus
241  << ") + DROPS (" << m_ulDrops << ")");
242 
243  Simulator::Destroy();
244 }
Test end-to-end flow when RLC UM is being used.
uint32_t m_dlDrops
number of Dl drops
double m_losses
error rate
void UlDropEvent(Ptr< const Packet > p)
UL drop event.
void DoRun() override
Implementation to actually run this TestCase.
void DlDropEvent(Ptr< const Packet > p)
DL drop event.
uint32_t m_seed
random number seed
uint32_t m_ulDrops
number of UL drops
Test suite for RlcUmE2eTestCase.
LteRlcUmE2eTestSuite()
Test x.x.x RLC UM: End-to-end flow.
This class can be used to hold variables of floating point type such as 'double' or 'float'.
Definition: double.h:42
holds a vector of ns3::NetDevice pointers
Ptr< NetDevice > Get(uint32_t i) const
Get the Ptr<NetDevice> stored in this container at a given index.
keep track of a set of node pointers.
void Create(uint32_t n)
Create n nodes and append pointers to them to the end of this NodeContainer.
void SetAttribute(std::string name, const AttributeValue &value)
Set a single attribute, raising fatal errors if unsuccessful.
Definition: object-base.cc:204
Hold objects of type Ptr<T>.
Definition: pointer.h:37
Hold variables of type string.
Definition: string.h:56
encapsulates test code
Definition: test.h:1060
TestDuration
How long the test takes to execute.
Definition: test.h:1064
void AddTestCase(TestCase *testCase, TestDuration duration=QUICK)
Add an individual child TestCase to this test suite.
Definition: test.cc:301
A suite of tests to run.
Definition: test.h:1256
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Definition: log.h:202
#define NS_LOG_INFO(msg)
Use NS_LOG to output a message of level LOG_INFO.
Definition: log.h:275
static LteRlcUmE2eTestSuite lteRlcUmE2eTestSuite
Static variable for test initialization.
#define NS_TEST_ASSERT_MSG_EQ(actual, limit, msg)
Test that an actual and expected (limit) value are equal and report and abort if not.
Definition: test.h:144
Time Seconds(double value)
Construct a Time in the indicated unit.
Definition: nstime.h:1326
Every class exported by the ns3 library is enclosed in the ns3 namespace.
Callback< R, Args... > MakeCallback(R(T::*memPtr)(Args...), OBJ objPtr)
Build Callbacks for class method members which take varying numbers of arguments and potentially retu...
Definition: callback.h:704