A Discrete-Event Network Simulator
API
lte-test-rlc-um-e2e.cc
Go to the documentation of this file.
1 /* -*- Mode: C++; c-file-style: "gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 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: Manuel Requena <manuel.requena@cttc.es>
19  */
20 
21 #include "ns3/config.h"
22 #include "ns3/simulator.h"
23 #include "ns3/pointer.h"
24 #include "ns3/log.h"
25 #include "ns3/packet.h"
26 #include "ns3/node-container.h"
27 #include "ns3/net-device-container.h"
28 #include "ns3/error-model.h"
29 #include "ns3/rng-seed-manager.h"
30 #include "ns3/radio-bearer-stats-calculator.h"
31 #include "ns3/lte-rlc-header.h"
32 #include "ns3/lte-rlc-um.h"
33 
34 #include "lte-simple-helper.h"
35 #include "lte-test-entities.h"
36 #include "lte-test-rlc-um-e2e.h"
37 
38 
39 using namespace ns3;
40 
41 NS_LOG_COMPONENT_DEFINE ("LteRlcUmE2eTest");
42 
52  : TestSuite ("lte-rlc-um-e2e", SYSTEM)
53 {
54  // NS_LOG_INFO ("Creating LteRlcUmE2eTestSuite");
55 
56  double losses[] = {0.0, 0.10, 0.25, 0.50, 0.75, 0.90, 1.00};
57  uint32_t seeds[] = {1111, 2222, 3333, 4444, 5555, 6666, 7777, 8888, 9999, 10101};
58 
59  for ( uint32_t l = 0 ; l < (sizeof (losses) / sizeof (double)) ; l++ )
60  {
61  for ( uint32_t s = 0 ; s < (sizeof (seeds) / sizeof (uint32_t)) ; s++ )
62  {
63  std::ostringstream name;
64  name << " Losses = " << losses[l] << "%. Seed = " << seeds[s];
65  TestCase::TestDuration testDuration;
66  if (l == 1 && s == 0)
67  {
68  testDuration = TestCase::QUICK;
69  }
70  else
71  {
72  testDuration = TestCase::EXTENSIVE;
73  }
74  AddTestCase (new LteRlcUmE2eTestCase (name.str (), seeds[s], losses[l]), testDuration);
75  }
76  }
77 }
78 
80 
81 
86 LteRlcUmE2eTestCase::LteRlcUmE2eTestCase (std::string name, uint32_t seed, double losses)
87  : TestCase (name)
88 {
89  // NS_LOG_UNCOND ("Creating LteRlcUmTestingTestCase: " + name);
90 
91  m_seed = seed;
92  m_losses = losses;
93 
94  m_dlDrops = 0;
95  m_ulDrops = 0;
96 }
97 
99 {
100 }
101 
102 
103 void
105 {
106  // NS_LOG_FUNCTION (this);
107  m_dlDrops++;
108 }
109 
110 void
112 {
113  // NS_LOG_FUNCTION (this);
114  m_ulDrops++;
115 }
116 
117 void
119 {
120  uint16_t numberOfNodes = 1;
121 
122  // LogLevel level = (LogLevel) (LOG_LEVEL_ALL | LOG_PREFIX_TIME | LOG_PREFIX_NODE | LOG_PREFIX_FUNC);
123  // LogComponentEnable ("LteRlcUmE2eTest", level);
124  // LogComponentEnable ("ErrorModel", level);
125  // LogComponentEnable ("LteSimpleHelper", level);
126  // LogComponentEnable ("LteSimpleNetDevice", level);
127  // LogComponentEnable ("SimpleNetDevice", level);
128  // LogComponentEnable ("SimpleChannel", level);
129  // LogComponentEnable ("LteTestEntities", level);
130  // LogComponentEnable ("LtePdcp", level);
131  // LogComponentEnable ("LteRlc", level);
132  // LogComponentEnable ("LteRlcUm", level);
133  // LogComponentEnable ("LteRlcAm", level);
134 
135  RngSeedManager::SetSeed (m_seed);
136 
137  Ptr<LteSimpleHelper> lteSimpleHelper = CreateObject<LteSimpleHelper> ();
138  // lteSimpleHelper->EnableLogComponents ();
139  // lteSimpleHelper->EnableTraces ();
140 
141  lteSimpleHelper->SetAttribute ("RlcEntity", StringValue ("RlcUm"));
142 
143  // eNB and UE nodes
144  NodeContainer ueNodes;
145  NodeContainer enbNodes;
146  enbNodes.Create (numberOfNodes);
147  ueNodes.Create (numberOfNodes);
148 
149  // Install LTE Devices to the nodes
150  NetDeviceContainer enbLteDevs = lteSimpleHelper->InstallEnbDevice (enbNodes);
151  NetDeviceContainer ueLteDevs = lteSimpleHelper->InstallUeDevice (ueNodes);
152 
153  // Note: Just one eNB and UE are supported. Everything is done in InstallEnbDevice and 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), EpcTft::Default ());
162 
163  // Error models: downlink and uplink
164  Ptr<RateErrorModel> dlEm = CreateObject<RateErrorModel> ();
165  dlEm->SetAttribute ("ErrorRate", DoubleValue (m_losses));
166  dlEm->SetAttribute ("ErrorUnit", StringValue ("ERROR_UNIT_PACKET"));
167 
168  Ptr<RateErrorModel> ulEm = CreateObject<RateErrorModel> ();
169  ulEm->SetAttribute ("ErrorRate", DoubleValue (m_losses));
170  ulEm->SetAttribute ("ErrorUnit", StringValue ("ERROR_UNIT_PACKET"));
171 
172  // The below hooks will cause drops to be counted at simple phy layer
173  ueLteDevs.Get (0)->SetAttribute ("ReceiveErrorModel", PointerValue (dlEm));
174  ueLteDevs.Get (0)->TraceConnectWithoutContext ("PhyRxDrop", MakeCallback (&LteRlcUmE2eTestCase::DlDropEvent, this));
175  enbLteDevs.Get (0)->SetAttribute ("ReceiveErrorModel", PointerValue (ulEm));
176  enbLteDevs.Get (0)->TraceConnectWithoutContext ("PhyRxDrop", MakeCallback (&LteRlcUmE2eTestCase::UlDropEvent, this));
177 
178  // Sending packets from eNB RRC layer (eNB -> UE)
179  lteSimpleHelper->m_enbRrc->SetArrivalTime (Seconds (0.010));
180  lteSimpleHelper->m_enbRrc->SetPduSize (100);
181 
182  // MAC sends transmission opportunities (TxOpp)
183  lteSimpleHelper->m_enbMac->SetTxOppSize (150);
184  lteSimpleHelper->m_enbMac->SetTxOppTime (Seconds (0.005));
185  lteSimpleHelper->m_enbMac->SetTxOpportunityMode (LteTestMac::RANDOM_MODE);
186 
187  // Sending packets from UE RRC layer (UE -> eNB)
188  lteSimpleHelper->m_ueRrc->SetArrivalTime (Seconds (0.010));
189  lteSimpleHelper->m_ueRrc->SetPduSize (100);
190 
191  // MAC sends transmission opportunities (TxOpp)
192  lteSimpleHelper->m_ueMac->SetTxOppSize (150);
193  lteSimpleHelper->m_ueMac->SetTxOppTime (Seconds (0.005));
194  lteSimpleHelper->m_ueMac->SetTxOpportunityMode (LteTestMac::RANDOM_MODE);
195 
196  // Start/Stop pseudo-application at eNB RRC
197  Simulator::Schedule (Seconds (0.100), &LteTestRrc::Start, lteSimpleHelper->m_enbRrc);
198  Simulator::Schedule (Seconds (10.100), &LteTestRrc::Stop, lteSimpleHelper->m_enbRrc);
199 
200  // Start/Stop pseudo-application at UE RRC
201  Simulator::Schedule (Seconds (20.100), &LteTestRrc::Start, lteSimpleHelper->m_ueRrc);
202  Simulator::Schedule (Seconds (30.100), &LteTestRrc::Stop, lteSimpleHelper->m_ueRrc);
203 
204 
205  Simulator::Stop (Seconds (31.000));
206  Simulator::Run ();
207 
208  uint32_t txEnbRrcPdus = lteSimpleHelper->m_enbRrc->GetTxPdus ();
209  uint32_t rxUeRrcPdus = lteSimpleHelper->m_ueRrc->GetRxPdus ();
210 
211  uint32_t txUeRrcPdus = lteSimpleHelper->m_ueRrc->GetTxPdus ();
212  uint32_t rxEnbRrcPdus = lteSimpleHelper->m_enbRrc->GetRxPdus ();
213 
214  // NS_LOG_INFO ("Seed = " << m_seed);
215  // NS_LOG_INFO ("Losses (%) = " << uint32_t (m_losses * 100));
216 
217  // NS_LOG_INFO ("dl dev drops = " << m_dlDrops);
218  // NS_LOG_INFO ("ul dev drops = " << m_ulDrops);
219 
220  // NS_LOG_INFO ("eNB tx RRC count = " << txEnbRrcPdus);
221  // NS_LOG_INFO ("eNB rx RRC count = " << rxEnbRrcPdus);
222  // NS_LOG_INFO ("UE tx RRC count = " << txUeRrcPdus);
223  // NS_LOG_INFO ("UE rx RRC count = " << rxUeRrcPdus);
224 
225  NS_LOG_INFO (m_seed << "\t" << m_losses << "\t" << txEnbRrcPdus << "\t" << rxUeRrcPdus << "\t" << m_dlDrops);
226  NS_LOG_INFO (m_seed << "\t" << m_losses << "\t" << txUeRrcPdus << "\t" << rxEnbRrcPdus << "\t" << m_ulDrops);
227 
228  NS_TEST_ASSERT_MSG_EQ (txEnbRrcPdus, rxUeRrcPdus + m_dlDrops,
229  "Downlink: TX PDUs (" << txEnbRrcPdus << ") != RX PDUs (" << rxUeRrcPdus << ") + DROPS (" << m_dlDrops << ")");
230  NS_TEST_ASSERT_MSG_EQ (txUeRrcPdus, rxEnbRrcPdus + m_ulDrops,
231  "Uplink: TX PDUs (" << txUeRrcPdus << ") != RX PDUs (" << rxEnbRrcPdus << ") + DROPS (" << m_ulDrops << ")");
232 
233  Simulator::Destroy ();
234 }
Ptr< LteTestRrc > m_enbRrc
ENB RRC.
Ptr< NetDevice > Get(uint32_t i) const
Get the Ptr<NetDevice> stored in this container at a given index.
uint32_t m_dlDrops
number of Dl drops
Hold variables of type string.
Definition: string.h:41
A suite of tests to run.
Definition: test.h:1343
static LteRlcUmE2eTestSuite lteRlcUmE2eTestSuite
uint32_t m_ulDrops
number of UL drops
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Definition: log.h:205
Ptr< LteTestRrc > m_ueRrc
UE RRC.
#define NS_LOG_INFO(msg)
Use NS_LOG to output a message of level LOG_INFO.
Definition: log.h:281
void SetTxOpportunityMode(uint8_t mode)
Set transmit opportunity mode.
Ptr< LteTestMac > m_ueMac
UE MAC.
encapsulates test code
Definition: test.h:1153
Ptr< LteTestMac > m_enbMac
ENB MAC.
void AddTestCase(TestCase *testCase, TestDuration duration=QUICK)
Add an individual child TestCase to this test suite.
Definition: test.cc:299
#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:166
holds a vector of ns3::NetDevice pointers
NetDeviceContainer InstallEnbDevice(NodeContainer c)
create a set of eNB devices
void SetTxOppTime(Time txOppTime)
Set transmit opportunity time.
TestDuration
How long the test takes to execute.
Definition: test.h:1157
Every class exported by the ns3 library is enclosed in the ns3 namespace.
keep track of a set of node pointers.
Hold objects of type Ptr<T>.
Definition: pointer.h:36
NetDeviceContainer InstallUeDevice(NodeContainer c)
create a set of UE devices
void UlDropEvent(Ptr< const Packet > p)
UL drop event.
void SetTxOppSize(uint32_t txOppSize)
Set transmit opportunity time.
void DlDropEvent(Ptr< const Packet > p)
DL drop event.
Time Seconds(double value)
Construct a Time in the indicated unit.
Definition: nstime.h:1289
uint32_t m_seed
random number seed
LteRlcUmE2eTestSuite()
Test x.x.x RLC UM: End-to-end flow.
virtual void DoRun(void)
Implementation to actually run this TestCase.
double m_losses
error rate
void Create(uint32_t n)
Create n nodes and append pointers to them to the end of this NodeContainer.
Test end-to-end flow when RLC UM is being used.
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
Callback< R, Ts... > MakeCallback(R(T::*memPtr)(Ts...), OBJ objPtr)
Build Callbacks for class method members which take varying numbers of arguments and potentially retu...
Definition: callback.h:1642
Test suite for RlcUmE2eTestCase.