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
79
84LteRlcUmE2eTestCase::LteRlcUmE2eTestCase(std::string name, uint32_t seed, double losses)
85 : TestCase(name)
86{
87 // NS_LOG_UNCOND ("Creating LteRlcUmTestingTestCase: " + name);
88
89 m_seed = seed;
90 m_losses = losses;
91
92 m_dlDrops = 0;
93 m_ulDrops = 0;
94}
95
97{
98}
99
100void
102{
103 // NS_LOG_FUNCTION (this);
104 m_dlDrops++;
105}
106
107void
109{
110 // NS_LOG_FUNCTION (this);
111 m_ulDrops++;
112}
113
114void
116{
117 uint16_t numberOfNodes = 1;
118
119 // LogLevel level = (LogLevel) (LOG_LEVEL_ALL | LOG_PREFIX_TIME | LOG_PREFIX_NODE |
120 // LOG_PREFIX_FUNC); LogComponentEnable ("LteRlcUmE2eTest", level); LogComponentEnable
121 // ("ErrorModel", level); LogComponentEnable ("LteSimpleHelper", level); LogComponentEnable
122 // ("LteSimpleNetDevice", level); LogComponentEnable ("SimpleNetDevice", level);
123 // LogComponentEnable ("SimpleChannel", level);
124 // LogComponentEnable ("LteTestEntities", level);
125 // LogComponentEnable ("LtePdcp", level);
126 // LogComponentEnable ("LteRlc", level);
127 // LogComponentEnable ("LteRlcUm", level);
128 // LogComponentEnable ("LteRlcAm", level);
129
130 RngSeedManager::SetSeed(m_seed);
131
132 Ptr<LteSimpleHelper> lteSimpleHelper = CreateObject<LteSimpleHelper>();
133 // lteSimpleHelper->EnableLogComponents ();
134 // lteSimpleHelper->EnableTraces ();
135
136 lteSimpleHelper->SetAttribute("RlcEntity", StringValue("RlcUm"));
137
138 // eNB and UE nodes
139 NodeContainer ueNodes;
140 NodeContainer enbNodes;
141 enbNodes.Create(numberOfNodes);
142 ueNodes.Create(numberOfNodes);
143
144 // Install LTE Devices to the nodes
145 NetDeviceContainer enbLteDevs = lteSimpleHelper->InstallEnbDevice(enbNodes);
146 NetDeviceContainer ueLteDevs = lteSimpleHelper->InstallUeDevice(ueNodes);
147
148 // Note: Just one eNB and UE are supported. Everything is done in InstallEnbDevice and
149 // InstallUeDevice
150
151 // Attach one UE per eNodeB
152 // for (uint16_t i = 0; i < numberOfNodes; i++)
153 // {
154 // lteSimpleHelper->Attach (ueLteDevs.Get(i), enbLteDevs.Get(i));
155 // }
156
157 // lteSimpleHelper->ActivateEpsBearer (ueLteDevs, EpsBearer (EpsBearer::NGBR_VIDEO_TCP_DEFAULT),
158 // EpcTft::Default ());
159
160 // Error models: downlink and uplink
161 Ptr<RateErrorModel> dlEm = CreateObject<RateErrorModel>();
162 dlEm->SetAttribute("ErrorRate", DoubleValue(m_losses));
163 dlEm->SetAttribute("ErrorUnit", StringValue("ERROR_UNIT_PACKET"));
164
165 Ptr<RateErrorModel> ulEm = CreateObject<RateErrorModel>();
166 ulEm->SetAttribute("ErrorRate", DoubleValue(m_losses));
167 ulEm->SetAttribute("ErrorUnit", StringValue("ERROR_UNIT_PACKET"));
168
169 // The below hooks will cause drops to be counted at simple phy layer
170 ueLteDevs.Get(0)->SetAttribute("ReceiveErrorModel", PointerValue(dlEm));
171 ueLteDevs.Get(0)->TraceConnectWithoutContext(
172 "PhyRxDrop",
174 enbLteDevs.Get(0)->SetAttribute("ReceiveErrorModel", PointerValue(ulEm));
175 enbLteDevs.Get(0)->TraceConnectWithoutContext(
176 "PhyRxDrop",
178
179 // Sending packets from eNB RRC layer (eNB -> UE)
180 lteSimpleHelper->m_enbRrc->SetArrivalTime(Seconds(0.010));
181 lteSimpleHelper->m_enbRrc->SetPduSize(100);
182
183 // MAC sends transmission opportunities (TxOpp)
184 lteSimpleHelper->m_enbMac->SetTxOppSize(150);
185 lteSimpleHelper->m_enbMac->SetTxOppTime(Seconds(0.005));
186 lteSimpleHelper->m_enbMac->SetTxOpportunityMode(LteTestMac::RANDOM_MODE);
187
188 // Sending packets from UE RRC layer (UE -> eNB)
189 lteSimpleHelper->m_ueRrc->SetArrivalTime(Seconds(0.010));
190 lteSimpleHelper->m_ueRrc->SetPduSize(100);
191
192 // MAC sends transmission opportunities (TxOpp)
193 lteSimpleHelper->m_ueMac->SetTxOppSize(150);
194 lteSimpleHelper->m_ueMac->SetTxOppTime(Seconds(0.005));
195 lteSimpleHelper->m_ueMac->SetTxOpportunityMode(LteTestMac::RANDOM_MODE);
196
197 // Start/Stop pseudo-application at eNB RRC
198 Simulator::Schedule(Seconds(0.100), &LteTestRrc::Start, lteSimpleHelper->m_enbRrc);
199 Simulator::Schedule(Seconds(10.100), &LteTestRrc::Stop, lteSimpleHelper->m_enbRrc);
200
201 // Start/Stop pseudo-application at UE RRC
202 Simulator::Schedule(Seconds(20.100), &LteTestRrc::Start, lteSimpleHelper->m_ueRrc);
203 Simulator::Schedule(Seconds(30.100), &LteTestRrc::Stop, lteSimpleHelper->m_ueRrc);
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"
226 << m_dlDrops);
227 NS_LOG_INFO(m_seed << "\t" << m_losses << "\t" << txUeRrcPdus << "\t" << rxEnbRrcPdus << "\t"
228 << m_ulDrops);
229
230 NS_TEST_ASSERT_MSG_EQ(txEnbRrcPdus,
231 rxUeRrcPdus + m_dlDrops,
232 "Downlink: TX PDUs (" << txEnbRrcPdus << ") != RX PDUs (" << rxUeRrcPdus
233 << ") + DROPS (" << m_dlDrops << ")");
234 NS_TEST_ASSERT_MSG_EQ(txUeRrcPdus,
235 rxEnbRrcPdus + m_ulDrops,
236 "Uplink: TX PDUs (" << txUeRrcPdus << ") != RX PDUs (" << rxEnbRrcPdus
237 << ") + DROPS (" << m_ulDrops << ")");
238
239 Simulator::Destroy();
240}
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:258
Hold objects of type Ptr<T>.
Definition: pointer.h:37
Hold variables of type string.
Definition: string.h:42
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
#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:1338
static LteRlcUmE2eTestSuite lteRlcUmE2eTestSuite
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