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
38using namespace ns3;
39
40NS_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
88LteRlcUmE2eTestCase::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
104void
106{
107 // NS_LOG_FUNCTION (this);
108 m_dlDrops++;
109}
110
111void
113{
114 // NS_LOG_FUNCTION (this);
115 m_ulDrops++;
116}
117
118void
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:200
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:305
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:1336
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:691