A Discrete-Event Network Simulator
API
test-lte-x2-handover-measures.cc
Go to the documentation of this file.
1 /* -*- Mode: C++; c-file-style: "gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2013 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  * Authors: Nicola Baldo <nbaldo@cttc.es>
19  * Manuel Requena <manuel.requena@cttc.es>
20  */
21 
22 #include <ns3/core-module.h>
23 #include <ns3/network-module.h>
24 #include <ns3/mobility-module.h>
25 #include <ns3/lte-module.h>
26 #include <ns3/internet-module.h>
27 #include <ns3/applications-module.h>
28 #include <ns3/point-to-point-module.h>
29 
30 using namespace ns3;
31 
32 NS_LOG_COMPONENT_DEFINE ("LteX2HandoverMeasuresTest");
33 
35 {
39  uint32_t ueDeviceIndex;
40  uint32_t enbDeviceIndex;
41 
42  CheckPointEvent (Time start, Time stop, Time interval, uint32_t ueIndex, uint32_t enbIndex)
43  : checkStartTime (start),
44  checkStopTime (stop),
45  checkInterval (interval),
46  ueDeviceIndex (ueIndex),
47  enbDeviceIndex (enbIndex)
48  {
49  }
50 };
51 
52 
54 {
55 public:
72  LteX2HandoverMeasuresTestCase (uint32_t nEnbs, uint32_t nUes, uint32_t nDedicatedBearers,
73  std::list<CheckPointEvent> checkPointEventList,
74  std::string checkPointEventListName,
75  bool useUdp, std::string schedulerType,
76  std::string handoverAlgorithmType, bool admitHo,
77  bool useIdealRrc);
78 
79 private:
80  static std::string BuildNameString (uint32_t nEnbs, uint32_t nUes, uint32_t nDedicatedBearers,
81  std::string checkPointEventListName,
82  bool useUdp, std::string schedulerType,
83  std::string handoverAlgorithmType, bool admitHo,
84  bool useIdealRrc);
85  virtual void DoRun (void);
86  void CheckConnected (Ptr<NetDevice> ueDevice, Ptr<NetDevice> enbDevice);
87 
88  uint32_t m_nEnbs; // number of eNBs in the test
89  uint32_t m_nUes; // number of UEs in the test
90  uint32_t m_nDedicatedBearers; // number of UEs in the test
91  std::list<CheckPointEvent> m_checkPointEventList;
93  bool m_epc;
94  bool m_useUdp;
95  std::string m_schedulerType;
97  bool m_admitHo;
101 
102  struct BearerData
103  {
104  uint32_t bid;
107  uint32_t dlOldTotalRx;
108  uint32_t ulOldTotalRx;
109  };
110 
111  struct UeData
112  {
113  uint32_t id;
114  std::list<BearerData> bearerDataList;
115  };
116 
117  void SaveStats (uint32_t ueIndex);
118  void CheckStats (uint32_t ueIndex);
119 
120  std::vector<UeData> m_ueDataVector;
121 
125  const uint32_t m_udpClientPktSize;
126 };
127 
128 
129 std::string
130 LteX2HandoverMeasuresTestCase::BuildNameString (uint32_t nEnbs, uint32_t nUes, uint32_t nDedicatedBearers,
131  std::string checkPointEventListName,
132  bool useUdp, std::string schedulerType,
133  std::string handoverAlgorithmType, bool admitHo,
134  bool useIdealRrc)
135 {
136  std::ostringstream oss;
137  oss << "nEnbs=" << nEnbs
138  << " nUes=" << nUes
139  << " nDedicatedBearers=" << nDedicatedBearers
140  << " udp=" << useUdp
141  << " " << schedulerType
142  << " " << handoverAlgorithmType
143  << " admitHo=" << admitHo
144  << " hoList: " << checkPointEventListName;
145  if (useIdealRrc)
146  {
147  oss << ", ideal RRC";
148  }
149  else
150  {
151  oss << ", real RRC";
152  }
153  return oss.str ();
154 }
155 
156 LteX2HandoverMeasuresTestCase::LteX2HandoverMeasuresTestCase (uint32_t nEnbs, uint32_t nUes, uint32_t nDedicatedBearers,
157  std::list<CheckPointEvent> checkPointEventList,
158  std::string checkPointEventListName,
159  bool useUdp, std::string schedulerType,
160  std::string handoverAlgorithmType, bool admitHo,
161  bool useIdealRrc)
162  : TestCase (BuildNameString (nEnbs, nUes, nDedicatedBearers,
163  checkPointEventListName, useUdp, schedulerType,
164  handoverAlgorithmType, admitHo, useIdealRrc)),
165  m_nEnbs (nEnbs),
166  m_nUes (nUes),
167  m_nDedicatedBearers (nDedicatedBearers),
168  m_checkPointEventList (checkPointEventList),
169  m_checkPointEventListName (checkPointEventListName),
170  m_epc (true),
171  m_useUdp (useUdp),
172  m_schedulerType (schedulerType),
173  m_handoverAlgorithmType (handoverAlgorithmType),
174  m_admitHo (admitHo),
175  m_useIdealRrc (useIdealRrc),
176  m_maxHoDuration (Seconds (0.1)),
177  m_statsDuration (Seconds (0.5)),
178  m_udpClientInterval (Seconds (0.01)),
179  m_udpClientPktSize (100)
180 {
181 }
182 
183 void
185 {
190  m_useIdealRrc));
191 
192  Config::Reset ();
193  Config::SetDefault ("ns3::UdpClient::Interval", TimeValue (m_udpClientInterval));
194  Config::SetDefault ("ns3::UdpClient::MaxPackets", UintegerValue (1000000));
195  Config::SetDefault ("ns3::UdpClient::PacketSize", UintegerValue (m_udpClientPktSize));
196  Config::SetDefault ("ns3::LteEnbRrc::HandoverJoiningTimeoutDuration", TimeValue (MilliSeconds (200)));
197  Config::SetDefault ("ns3::LteEnbPhy::TxPower", DoubleValue (20));
198 
199  //Disable Uplink Power Control
200  Config::SetDefault ("ns3::LteUePhy::EnableUplinkPowerControl", BooleanValue (false));
201 
202  int64_t stream = 1;
203 
204  m_lteHelper = CreateObject<LteHelper> ();
205  m_lteHelper->SetAttribute ("PathlossModel", StringValue ("ns3::FriisSpectrumPropagationLossModel"));
208 
209  if (m_handoverAlgorithmType == "ns3::A2A4RsrqHandoverAlgorithm")
210  {
211  m_lteHelper->SetHandoverAlgorithmType ("ns3::A2A4RsrqHandoverAlgorithm");
212  m_lteHelper->SetHandoverAlgorithmAttribute ("ServingCellThreshold",
213  UintegerValue (30));
214  m_lteHelper->SetHandoverAlgorithmAttribute ("NeighbourCellOffset",
215  UintegerValue (1));
216  }
217  else if (m_handoverAlgorithmType == "ns3::A3RsrpHandoverAlgorithm")
218  {
219  m_lteHelper->SetHandoverAlgorithmType ("ns3::A3RsrpHandoverAlgorithm");
221  DoubleValue (1.5));
222  m_lteHelper->SetHandoverAlgorithmAttribute ("TimeToTrigger",
223  TimeValue (MilliSeconds (128)));
224  }
225  else
226  {
227  NS_FATAL_ERROR ("Unknown handover algorithm " << m_handoverAlgorithmType);
228  }
229 
230  double distance = 1000.0; // m
231  double speed = 150; // m/s
232 
233  NodeContainer enbNodes;
234  enbNodes.Create (m_nEnbs);
235  NodeContainer ueNodes;
236  ueNodes.Create (m_nUes);
237 
238  if (m_epc)
239  {
240  m_epcHelper = CreateObject<PointToPointEpcHelper> ();
242  }
243 
244  // Install Mobility Model in eNBs
245  // eNBs are located along a line in the X axis
246  Ptr<ListPositionAllocator> enbPositionAlloc = CreateObject<ListPositionAllocator> ();
247  for (uint16_t i = 0; i < m_nEnbs; i++)
248  {
249  Vector enbPosition (distance * (i + 1), 0, 0);
250  enbPositionAlloc->Add (enbPosition);
251  }
252  MobilityHelper enbMobility;
253  enbMobility.SetMobilityModel ("ns3::ConstantPositionMobilityModel");
254  enbMobility.SetPositionAllocator (enbPositionAlloc);
255  enbMobility.Install (enbNodes);
256 
257  // Install Mobility Model in UE
258  // UE moves with a constant speed along the X axis
259  MobilityHelper ueMobility;
260  ueMobility.SetMobilityModel ("ns3::ConstantVelocityMobilityModel");
261  ueMobility.Install (ueNodes);
262  for (uint16_t i = 0; i < m_nUes; i++)
263  {
264  ueNodes.Get (i)->GetObject<MobilityModel> ()->SetPosition (Vector (0, 0, 0));
265  ueNodes.Get (i)->GetObject<ConstantVelocityMobilityModel> ()->SetVelocity (Vector (speed, 0, 0));
266  }
267 
268  NetDeviceContainer enbDevices;
269  enbDevices = m_lteHelper->InstallEnbDevice (enbNodes);
270  stream += m_lteHelper->AssignStreams (enbDevices, stream);
271  for (NetDeviceContainer::Iterator it = enbDevices.Begin ();
272  it != enbDevices.End ();
273  ++it)
274  {
275  Ptr<LteEnbRrc> enbRrc = (*it)->GetObject<LteEnbNetDevice> ()->GetRrc ();
276  enbRrc->SetAttribute ("AdmitHandoverRequest", BooleanValue (m_admitHo));
277  }
278 
279  NetDeviceContainer ueDevices;
280  ueDevices = m_lteHelper->InstallUeDevice (ueNodes);
281  stream += m_lteHelper->AssignStreams (ueDevices, stream);
282 
283  Ipv4Address remoteHostAddr;
284  Ipv4StaticRoutingHelper ipv4RoutingHelper;
285  Ipv4InterfaceContainer ueIpIfaces;
286  Ptr<Node> remoteHost;
287  if (m_epc)
288  {
289  // Create a single RemoteHost
290  NodeContainer remoteHostContainer;
291  remoteHostContainer.Create (1);
292  remoteHost = remoteHostContainer.Get (0);
293  InternetStackHelper internet;
294  internet.Install (remoteHostContainer);
295 
296  // Create the Internet
297  PointToPointHelper p2ph;
298  p2ph.SetDeviceAttribute ("DataRate", DataRateValue (DataRate ("100Gb/s")));
299  p2ph.SetDeviceAttribute ("Mtu", UintegerValue (1500));
300  p2ph.SetChannelAttribute ("Delay", TimeValue (Seconds (0.010)));
301  Ptr<Node> pgw = m_epcHelper->GetPgwNode ();
302  NetDeviceContainer internetDevices = p2ph.Install (pgw, remoteHost);
303  Ipv4AddressHelper ipv4h;
304  ipv4h.SetBase ("1.0.0.0", "255.0.0.0");
305  Ipv4InterfaceContainer internetIpIfaces = ipv4h.Assign (internetDevices);
306  // in this container, interface 0 is the pgw, 1 is the remoteHost
307  remoteHostAddr = internetIpIfaces.GetAddress (1);
308 
309  Ipv4StaticRoutingHelper ipv4RoutingHelper;
310  Ptr<Ipv4StaticRouting> remoteHostStaticRouting = ipv4RoutingHelper.GetStaticRouting (remoteHost->GetObject<Ipv4> ());
311  remoteHostStaticRouting->AddNetworkRouteTo (Ipv4Address ("7.0.0.0"), Ipv4Mask ("255.0.0.0"), 1);
312 
313  // Install the IP stack on the UEs
314  internet.Install (ueNodes);
315  ueIpIfaces = m_epcHelper->AssignUeIpv4Address (NetDeviceContainer (ueDevices));
316  }
317 
318  // attachment (needs to be done after IP stack configuration)
319  // all UEs attached to eNB 0 at the beginning
320  m_lteHelper->Attach (ueDevices, enbDevices.Get (0));
321 
322  if (m_epc)
323  {
324  bool epcDl = true;
325  bool epcUl = false;
326  // the rest of this block is copied from lena-dual-stripe
327 
328 
329  // Install and start applications on UEs and remote host
330  uint16_t dlPort = 10000;
331  uint16_t ulPort = 20000;
332 
333  // randomize a bit start times to avoid simulation artifacts
334  // (e.g., buffer overflows due to packet transmissions happening
335  // exactly at the same time)
336  Ptr<UniformRandomVariable> startTimeSeconds = CreateObject<UniformRandomVariable> ();
337  startTimeSeconds->SetAttribute ("Min", DoubleValue (0));
338  startTimeSeconds->SetAttribute ("Max", DoubleValue (0.010));
339  startTimeSeconds->SetStream (stream++);
340 
341  for (uint32_t u = 0; u < ueNodes.GetN (); ++u)
342  {
343  Ptr<Node> ue = ueNodes.Get (u);
344  // Set the default gateway for the UE
345  Ptr<Ipv4StaticRouting> ueStaticRouting = ipv4RoutingHelper.GetStaticRouting (ue->GetObject<Ipv4> ());
346  ueStaticRouting->SetDefaultRoute (m_epcHelper->GetUeDefaultGatewayAddress (), 1);
347 
348  UeData ueData;
349 
350  for (uint32_t b = 0; b < m_nDedicatedBearers; ++b)
351  {
352  ++dlPort;
353  ++ulPort;
354 
357  BearerData bearerData;
358 
359  if (m_useUdp)
360  {
361  if (epcDl)
362  {
363  UdpClientHelper dlClientHelper (ueIpIfaces.GetAddress (u), dlPort);
364  clientApps.Add (dlClientHelper.Install (remoteHost));
365  PacketSinkHelper dlPacketSinkHelper ("ns3::UdpSocketFactory",
366  InetSocketAddress (Ipv4Address::GetAny (), dlPort));
367  ApplicationContainer sinkContainer = dlPacketSinkHelper.Install (ue);
368  bearerData.dlSink = sinkContainer.Get (0)->GetObject<PacketSink> ();
369  serverApps.Add (sinkContainer);
370 
371  }
372  if (epcUl)
373  {
374  UdpClientHelper ulClientHelper (remoteHostAddr, ulPort);
375  clientApps.Add (ulClientHelper.Install (ue));
376  PacketSinkHelper ulPacketSinkHelper ("ns3::UdpSocketFactory",
377  InetSocketAddress (Ipv4Address::GetAny (), ulPort));
378  ApplicationContainer sinkContainer = ulPacketSinkHelper.Install (remoteHost);
379  bearerData.ulSink = sinkContainer.Get (0)->GetObject<PacketSink> ();
380  serverApps.Add (sinkContainer);
381  }
382  }
383  else // use TCP
384  {
385  if (epcDl)
386  {
387  BulkSendHelper dlClientHelper ("ns3::TcpSocketFactory",
388  InetSocketAddress (ueIpIfaces.GetAddress (u), dlPort));
389  dlClientHelper.SetAttribute ("MaxBytes", UintegerValue (0));
390  clientApps.Add (dlClientHelper.Install (remoteHost));
391  PacketSinkHelper dlPacketSinkHelper ("ns3::TcpSocketFactory",
392  InetSocketAddress (Ipv4Address::GetAny (), dlPort));
393  ApplicationContainer sinkContainer = dlPacketSinkHelper.Install (ue);
394  bearerData.dlSink = sinkContainer.Get (0)->GetObject<PacketSink> ();
395  serverApps.Add (sinkContainer);
396  }
397  if (epcUl)
398  {
399  BulkSendHelper ulClientHelper ("ns3::TcpSocketFactory",
400  InetSocketAddress (remoteHostAddr, ulPort));
401  ulClientHelper.SetAttribute ("MaxBytes", UintegerValue (0));
402  clientApps.Add (ulClientHelper.Install (ue));
403  PacketSinkHelper ulPacketSinkHelper ("ns3::TcpSocketFactory",
404  InetSocketAddress (Ipv4Address::GetAny (), ulPort));
405  ApplicationContainer sinkContainer = ulPacketSinkHelper.Install (remoteHost);
406  bearerData.ulSink = sinkContainer.Get (0)->GetObject<PacketSink> ();
407  serverApps.Add (sinkContainer);
408  }
409  } // end if (useUdp)
410 
411  Ptr<EpcTft> tft = Create<EpcTft> ();
412  if (epcDl)
413  {
415  dlpf.localPortStart = dlPort;
416  dlpf.localPortEnd = dlPort;
417  tft->Add (dlpf);
418  }
419  if (epcUl)
420  {
422  ulpf.remotePortStart = ulPort;
423  ulpf.remotePortEnd = ulPort;
424  tft->Add (ulpf);
425  }
426 
427  if (epcDl || epcUl)
428  {
429  EpsBearer bearer (EpsBearer::NGBR_VIDEO_TCP_DEFAULT);
430  m_lteHelper->ActivateDedicatedEpsBearer (ueDevices.Get (u), bearer, tft);
431  }
432  Time startTime = Seconds (startTimeSeconds->GetValue ());
433  serverApps.Start (startTime);
434  clientApps.Start (startTime);
435 
436  ueData.bearerDataList.push_back (bearerData);
437 
438  } // end for b
439 
440  m_ueDataVector.push_back (ueData);
441  }
442 
443  }
444  else // (epc == false)
445  {
446  // for radio bearer activation purposes, consider together home UEs and macro UEs
447  for (uint32_t u = 0; u < ueDevices.GetN (); ++u)
448  {
449  Ptr<NetDevice> ueDev = ueDevices.Get (u);
450  for (uint32_t b = 0; b < m_nDedicatedBearers; ++b)
451  {
452  enum EpsBearer::Qci q = EpsBearer::NGBR_VIDEO_TCP_DEFAULT;
453  EpsBearer bearer (q);
454  m_lteHelper->ActivateDataRadioBearer (ueDev, bearer);
455  }
456  }
457  }
458 
459 
460  m_lteHelper->AddX2Interface (enbNodes);
461 
462  // check initial RRC connection
463  const Time maxRrcConnectionEstablishmentDuration = Seconds (0.080);
464  for (NetDeviceContainer::Iterator it = ueDevices.Begin (); it != ueDevices.End (); ++it)
465  {
466  NS_LOG_FUNCTION (maxRrcConnectionEstablishmentDuration);
467  Simulator::Schedule (maxRrcConnectionEstablishmentDuration,
469  this, *it, enbDevices.Get (0));
470  }
471 
472  // schedule the checkpoint events
473 
474  Time stopTime = Seconds (0);
475  for (std::list<CheckPointEvent>::iterator checkPointEventIt = m_checkPointEventList.begin ();
476  checkPointEventIt != m_checkPointEventList.end ();
477  ++checkPointEventIt)
478  {
479  for (Time checkPointTime = checkPointEventIt->checkStartTime;
480  checkPointTime < checkPointEventIt->checkStopTime;
481  checkPointTime += checkPointEventIt->checkInterval)
482  {
483  Simulator::Schedule (checkPointTime, &LteX2HandoverMeasuresTestCase::CheckConnected,
484  this, ueDevices.Get (checkPointEventIt->ueDeviceIndex),
485  enbDevices.Get (checkPointEventIt->enbDeviceIndex));
486 
487  Time saveStatsTime = checkPointTime;
488  Simulator::Schedule (saveStatsTime, &LteX2HandoverMeasuresTestCase::SaveStats,
489  this, checkPointEventIt->ueDeviceIndex);
490 
491  Time checkStats = saveStatsTime + m_statsDuration;
492  Simulator::Schedule (checkStats, &LteX2HandoverMeasuresTestCase::CheckStats,
493  this, checkPointEventIt->ueDeviceIndex);
494 
495  if (stopTime <= checkStats)
496  {
497  stopTime = checkStats + Seconds (1);
498  }
499  }
500  }
501 
502  Simulator::Stop (stopTime);
503  Simulator::Run ();
504  Simulator::Destroy ();
505 }
506 
507 void
509 {
510  NS_LOG_FUNCTION (ueDevice << enbDevice);
511 
512  Ptr<LteUeNetDevice> ueLteDevice = ueDevice->GetObject<LteUeNetDevice> ();
513  Ptr<LteUeRrc> ueRrc = ueLteDevice->GetRrc ();
514  NS_TEST_ASSERT_MSG_EQ (ueRrc->GetState (), LteUeRrc::CONNECTED_NORMALLY, "Wrong LteUeRrc state!");
515 
516 
517  Ptr<LteEnbNetDevice> enbLteDevice = enbDevice->GetObject<LteEnbNetDevice> ();
518  Ptr<LteEnbRrc> enbRrc = enbLteDevice->GetRrc ();
519  uint16_t rnti = ueRrc->GetRnti ();
520  Ptr<UeManager> ueManager = enbRrc->GetUeManager (rnti);
521  NS_TEST_ASSERT_MSG_NE (ueManager, 0, "RNTI " << rnti << " not found in eNB");
522 
523  UeManager::State ueManagerState = ueManager->GetState ();
524  NS_TEST_ASSERT_MSG_EQ (ueManagerState, UeManager::CONNECTED_NORMALLY, "Wrong UeManager state!");
525  NS_ASSERT_MSG (ueManagerState == UeManager::CONNECTED_NORMALLY, "Wrong UeManager state!");
526 
527  uint16_t ueCellId = ueRrc->GetCellId ();
528  uint16_t enbCellId = enbLteDevice->GetCellId ();
529  uint8_t ueDlBandwidth = ueRrc->GetDlBandwidth ();
530  uint8_t enbDlBandwidth = enbLteDevice->GetDlBandwidth ();
531  uint8_t ueUlBandwidth = ueRrc->GetUlBandwidth ();
532  uint8_t enbUlBandwidth = enbLteDevice->GetUlBandwidth ();
533  uint8_t ueDlEarfcn = ueRrc->GetDlEarfcn ();
534  uint8_t enbDlEarfcn = enbLteDevice->GetDlEarfcn ();
535  uint8_t ueUlEarfcn = ueRrc->GetUlEarfcn ();
536  uint8_t enbUlEarfcn = enbLteDevice->GetUlEarfcn ();
537  uint64_t ueImsi = ueLteDevice->GetImsi ();
538  uint64_t enbImsi = ueManager->GetImsi ();
539 
540  NS_TEST_ASSERT_MSG_EQ (ueImsi, enbImsi, "inconsistent IMSI");
541  NS_TEST_ASSERT_MSG_EQ (ueCellId, enbCellId, "inconsistent CellId");
542  NS_TEST_ASSERT_MSG_EQ (ueDlBandwidth, enbDlBandwidth, "inconsistent DlBandwidth");
543  NS_TEST_ASSERT_MSG_EQ (ueUlBandwidth, enbUlBandwidth, "inconsistent UlBandwidth");
544  NS_TEST_ASSERT_MSG_EQ (ueDlEarfcn, enbDlEarfcn, "inconsistent DlEarfcn");
545  NS_TEST_ASSERT_MSG_EQ (ueUlEarfcn, enbUlEarfcn, "inconsistent UlEarfcn");
546 
547  ObjectMapValue enbDataRadioBearerMapValue;
548  ueManager->GetAttribute ("DataRadioBearerMap", enbDataRadioBearerMapValue);
549  NS_TEST_ASSERT_MSG_EQ (enbDataRadioBearerMapValue.GetN (), m_nDedicatedBearers + 1, "wrong num bearers at eNB");
550 
551  ObjectMapValue ueDataRadioBearerMapValue;
552  ueRrc->GetAttribute ("DataRadioBearerMap", ueDataRadioBearerMapValue);
553  NS_TEST_ASSERT_MSG_EQ (ueDataRadioBearerMapValue.GetN (), m_nDedicatedBearers + 1, "wrong num bearers at UE");
554 
555  ObjectMapValue::Iterator enbBearerIt = enbDataRadioBearerMapValue.Begin ();
556  ObjectMapValue::Iterator ueBearerIt = ueDataRadioBearerMapValue.Begin ();
557  while (enbBearerIt != enbDataRadioBearerMapValue.End ()
558  && ueBearerIt != ueDataRadioBearerMapValue.End ())
559  {
560  Ptr<LteDataRadioBearerInfo> enbDrbInfo = enbBearerIt->second->GetObject<LteDataRadioBearerInfo> ();
561  Ptr<LteDataRadioBearerInfo> ueDrbInfo = ueBearerIt->second->GetObject<LteDataRadioBearerInfo> ();
562  //NS_TEST_ASSERT_MSG_EQ (enbDrbInfo->m_epsBearer, ueDrbInfo->m_epsBearer, "epsBearer differs");
563  NS_TEST_ASSERT_MSG_EQ ((uint32_t) enbDrbInfo->m_epsBearerIdentity, (uint32_t) ueDrbInfo->m_epsBearerIdentity, "epsBearerIdentity differs");
564  NS_TEST_ASSERT_MSG_EQ ((uint32_t) enbDrbInfo->m_drbIdentity, (uint32_t) ueDrbInfo->m_drbIdentity, "drbIdentity differs");
565  //NS_TEST_ASSERT_MSG_EQ (enbDrbInfo->m_rlcConfig, ueDrbInfo->m_rlcConfig, "rlcConfig differs");
566  NS_TEST_ASSERT_MSG_EQ ((uint32_t) enbDrbInfo->m_logicalChannelIdentity, (uint32_t) ueDrbInfo->m_logicalChannelIdentity, "logicalChannelIdentity differs");
567  //NS_TEST_ASSERT_MSG_EQ (enbDrbInfo->m_logicalChannelConfig, ueDrbInfo->m_logicalChannelConfig, "logicalChannelConfig differs");
568 
569  ++enbBearerIt;
570  ++ueBearerIt;
571  }
572  NS_ASSERT_MSG (enbBearerIt == enbDataRadioBearerMapValue.End (), "too many bearers at eNB");
573  NS_ASSERT_MSG (ueBearerIt == ueDataRadioBearerMapValue.End (), "too many bearers at UE");
574 }
575 
576 void
578 {
579  NS_LOG_FUNCTION (ueIndex);
580  for (std::list<BearerData>::iterator it = m_ueDataVector.at (ueIndex).bearerDataList.begin ();
581  it != m_ueDataVector.at (ueIndex).bearerDataList.end ();
582  ++it)
583  {
584  if (it->dlSink)
585  {
586  it->dlOldTotalRx = it->dlSink->GetTotalRx ();
587  }
588  if (it->ulSink)
589  {
590  it->ulOldTotalRx = it->ulSink->GetTotalRx ();
591  }
592  }
593 }
594 
595 void
597 {
598  NS_LOG_FUNCTION (ueIndex);
599  uint32_t b = 1;
600  for (std::list<BearerData>::iterator it = m_ueDataVector.at (ueIndex).bearerDataList.begin ();
601  it != m_ueDataVector.at (ueIndex).bearerDataList.end ();
602  ++it)
603  {
604  uint32_t dlRx = 0;
605  uint32_t ulRx = 0;
606 
607  if (it->dlSink)
608  {
609  dlRx = it->dlSink->GetTotalRx () - it->dlOldTotalRx;
610  }
611 
612  if (it->ulSink)
613  {
614  ulRx = it->ulSink->GetTotalRx () - it->ulOldTotalRx;
615  }
617 
618  NS_LOG_LOGIC ("expBytes " << expectedBytes << " dlRx " << dlRx << " ulRx " << ulRx);
619 
620  // tolerance
621  if (it->dlSink)
622  {
623  NS_TEST_ASSERT_MSG_GT (dlRx, 0.500 * expectedBytes, "too few RX bytes in DL, ue=" << ueIndex << ", b=" << b);
624  }
625  if (it->ulSink)
626  {
627  NS_TEST_ASSERT_MSG_GT (ulRx, 0.500 * expectedBytes, "too few RX bytes in UL, ue=" << ueIndex << ", b=" << b);
628  }
629  ++b;
630  }
631 }
632 
633 
635 {
636 public:
638 };
639 
640 
642  : TestSuite ("lte-x2-handover-measures", SYSTEM)
643 {
644  Time checkInterval = Seconds (1);
645 
646  std::string cel1name ("ho: 0 -> 1");
647  std::list<CheckPointEvent> cel1;
648  cel1.push_back (CheckPointEvent (Seconds (1), Seconds (10.1), checkInterval, 0, 0));
649  cel1.push_back (CheckPointEvent (Seconds (11), Seconds (17), checkInterval, 0, 1));
650 
651  std::string cel2name ("ho: 0 -> 1 -> 2");
652  std::list<CheckPointEvent> cel2;
653  cel2.push_back (CheckPointEvent (Seconds (1), Seconds (10.1), checkInterval, 0, 0));
654  cel2.push_back (CheckPointEvent (Seconds (11), Seconds (17.1), checkInterval, 0, 1));
655  cel2.push_back (CheckPointEvent (Seconds (18), Seconds (24), checkInterval, 0, 2));
656 
657  std::string cel3name ("ho: 0 -> 1 -> 2 -> 3");
658  std::list<CheckPointEvent> cel3;
659  cel3.push_back (CheckPointEvent (Seconds (1), Seconds (10.1), checkInterval, 0, 0));
660  cel3.push_back (CheckPointEvent (Seconds (11), Seconds (17.1), checkInterval, 0, 1));
661  cel3.push_back (CheckPointEvent (Seconds (18), Seconds (24.1), checkInterval, 0, 2));
662  cel3.push_back (CheckPointEvent (Seconds (25), Seconds (37), checkInterval, 0, 3));
663 
664 
665  int32_t useIdealRrc;
666  std::string sched = "ns3::PfFfMacScheduler";
667  std::string ho = "ns3::A2A4RsrqHandoverAlgorithm";
668  for (useIdealRrc = 1; useIdealRrc >= 0; --useIdealRrc)
669  {
670  // nEnbs, nUes, nDBearers, celist, name, useUdp, sched, ho, admitHo, idealRrc
671  AddTestCase (new LteX2HandoverMeasuresTestCase (2, 1, 0, cel1, cel1name, true, sched, ho, true, useIdealRrc), TestCase::TAKES_FOREVER);
672  AddTestCase (new LteX2HandoverMeasuresTestCase (2, 1, 1, cel1, cel1name, true, sched, ho, true, useIdealRrc), TestCase::QUICK);
673  AddTestCase (new LteX2HandoverMeasuresTestCase (2, 1, 2, cel1, cel1name, true, sched, ho, true, useIdealRrc), TestCase::TAKES_FOREVER);
674  AddTestCase (new LteX2HandoverMeasuresTestCase (3, 1, 0, cel2, cel2name, true, sched, ho, true, useIdealRrc), TestCase::TAKES_FOREVER);
675  AddTestCase (new LteX2HandoverMeasuresTestCase (3, 1, 1, cel2, cel2name, true, sched, ho, true, useIdealRrc), TestCase::TAKES_FOREVER);
676  AddTestCase (new LteX2HandoverMeasuresTestCase (3, 1, 2, cel2, cel2name, true, sched, ho, true, useIdealRrc), TestCase::EXTENSIVE);
677  AddTestCase (new LteX2HandoverMeasuresTestCase (4, 1, 0, cel3, cel3name, true, sched, ho, true, useIdealRrc), TestCase::EXTENSIVE);
678  AddTestCase (new LteX2HandoverMeasuresTestCase (4, 1, 1, cel3, cel3name, true, sched, ho, true, useIdealRrc), TestCase::TAKES_FOREVER);
679  AddTestCase (new LteX2HandoverMeasuresTestCase (4, 1, 2, cel3, cel3name, true, sched, ho, true, useIdealRrc), TestCase::TAKES_FOREVER);
680  }
681 
682  sched = "ns3::RrFfMacScheduler";
683  for (useIdealRrc = 1; useIdealRrc >= 0; --useIdealRrc)
684  {
685  // nEnbs, nUes, nDBearers, celist, name, useUdp, sched, admitHo, idealRrc
686  AddTestCase (new LteX2HandoverMeasuresTestCase (2, 1, 0, cel1, cel1name, true, sched, ho, true, useIdealRrc), TestCase::EXTENSIVE);
687  AddTestCase (new LteX2HandoverMeasuresTestCase (3, 1, 0, cel2, cel2name, true, sched, ho, true, useIdealRrc), TestCase::TAKES_FOREVER);
688  AddTestCase (new LteX2HandoverMeasuresTestCase (4, 1, 0, cel3, cel3name, true, sched, ho, true, useIdealRrc), TestCase::TAKES_FOREVER);
689  }
690 
691  ho = "ns3::A3RsrpHandoverAlgorithm";
692  sched = "ns3::PfFfMacScheduler";
693  for (useIdealRrc = 1; useIdealRrc >= 0; --useIdealRrc)
694  {
695  // nEnbs, nUes, nDBearers, celist, name, useUdp, sched, admitHo, idealRrc
696  AddTestCase (new LteX2HandoverMeasuresTestCase (2, 1, 0, cel1, cel1name, true, sched, ho, true, useIdealRrc), TestCase::EXTENSIVE);
697  AddTestCase (new LteX2HandoverMeasuresTestCase (3, 1, 0, cel2, cel2name, true, sched, ho, true, useIdealRrc), TestCase::TAKES_FOREVER);
698  AddTestCase (new LteX2HandoverMeasuresTestCase (4, 1, 0, cel3, cel3name, true, sched, ho, true, useIdealRrc), TestCase::TAKES_FOREVER);
699  }
700 
701  sched = "ns3::RrFfMacScheduler";
702  for (useIdealRrc = 1; useIdealRrc >= 0; --useIdealRrc)
703  {
704  // nEnbs, nUes, nDBearers, celist, name, useUdp, sched, admitHo, idealRrc
705  AddTestCase (new LteX2HandoverMeasuresTestCase (2, 1, 0, cel1, cel1name, true, sched, ho, true, useIdealRrc), TestCase::QUICK);
706  AddTestCase (new LteX2HandoverMeasuresTestCase (3, 1, 0, cel2, cel2name, true, sched, ho, true, useIdealRrc), TestCase::TAKES_FOREVER);
707  AddTestCase (new LteX2HandoverMeasuresTestCase (4, 1, 0, cel3, cel3name, true, sched, ho, true, useIdealRrc), TestCase::EXTENSIVE);
708  }
709 
710 } // end of LteX2HandoverMeasuresTestSuite ()
711 
holds a vector of ns3::Application pointers.
Iterator Begin(void) const
Get an iterator which refers to the first NetDevice in the container.
uint8_t Add(PacketFilter f)
add a PacketFilter to the Traffic Flow Template
Definition: epc-tft.cc:157
Simulation virtual time values and global simulation resolution.
Definition: nstime.h:102
an Inet address class
Smart pointer class similar to boost::intrusive_ptr.
Definition: ptr.h:73
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by "...
void SetStream(int64_t stream)
Specifies the stream number for this RNG stream.
AttributeValue implementation for Boolean.
Definition: boolean.h:34
NetDeviceContainer InstallEnbDevice(NodeContainer c)
Create a set of eNodeB devices.
Definition: lte-helper.cc:382
A helper to make it easier to instantiate an ns3::BulkSendApplication on a set of nodes...
Ptr< PointToPointEpcHelper > m_epcHelper
holds a vector of std::pair of Ptr and interface index.
void SetDefaultRoute(Ipv4Address nextHop, uint32_t interface, uint32_t metric=0)
Add a default route to the static routing table.
Ptr< T > GetObject(void) const
Get a pointer to the requested aggregated Object.
Definition: object.h:462
Hold variables of type string.
Definition: string.h:41
Ptr< NetDevice > Get(uint32_t i) const
Get the Ptr stored in this container at a given index.
NetDeviceContainer Install(NodeContainer c)
a class to represent an Ipv4 address mask
Definition: ipv4-address.h:257
void Add(ApplicationContainer other)
Append the contents of another ApplicationContainer to the end of this container. ...
A suite of tests to run.
Definition: test.h:1333
def start()
Definition: core.py:1482
Ptr< LteUeRrc > GetRrc() const
uint64_t GetImsi() const
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:716
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Definition: log.h:201
Time MilliSeconds(uint64_t value)
Construct a Time in the indicated unit.
Definition: nstime.h:903
aggregate IP/TCP/UDP functionality to existing Nodes.
uint16_t localPortEnd
end of the port number range of the UE
Definition: epc-tft.h:115
#define NS_FATAL_ERROR(msg)
Report a fatal error with a message and terminate.
Definition: fatal-error.h:162
A helper to make it easier to instantiate an ns3::PacketSinkApplication on a set of nodes...
Build a set of PointToPointNetDevice objects.
encapsulates test code
Definition: test.h:1147
int64_t AssignStreams(NetDeviceContainer c, int64_t stream)
Assign a fixed random variable stream number to the random variables used.
Definition: lte-helper.cc:1110
void ActivateDataRadioBearer(NetDeviceContainer ueDevices, EpsBearer bearer)
Activate a Data Radio Bearer on a given UE devices (for LTE-only simulation).
Definition: lte-helper.cc:1046
void SetDeviceAttribute(std::string name, const AttributeValue &value)
Set an attribute value to be propagated to each NetDevice created by the helper.
State GetState() const
uint8_t ActivateDedicatedEpsBearer(NetDeviceContainer ueDevices, EpsBearer bearer, Ptr< EpcTft > tft)
Activate a dedicated EPS bearer on a given set of UE devices.
Definition: lte-helper.cc:824
void SetHandoverAlgorithmType(std::string type)
Set the type of handover algorithm to be used by eNodeB devices.
Definition: lte-helper.cc:273
ApplicationContainer Install(NodeContainer c)
double stopTime
static void SetPosition(Ptr< Node > node, Vector position)
Definition: wifi-ap.cc:86
tuple clientApps
Definition: first.py:54
std::map< uint32_t, Ptr< Object > >::const_iterator Iterator
Iterator type for traversing this container.
void SetSchedulerType(std::string type)
Set the type of scheduler to be used by eNodeB devices.
Definition: lte-helper.cc:225
uint32_t GetN(void) const
Get the number of Ptr stored in this container.
uint32_t GetN(void) const
Get the number of Ptr stored in this container.
Class for representing data rates.
Definition: data-rate.h:88
Keep track of the current position and velocity of an object.
double GetSeconds(void) const
Get an approximation of the time stored in this instance in the indicated unit.
Definition: nstime.h:341
ApplicationContainer Install(NodeContainer c) const
Install an ns3::BulkSendApplication on each node of the input container configured with all the attri...
This class contains the specification of EPS Bearers.
Definition: eps-bearer.h:71
LteX2HandoverMeasuresTestCase(uint32_t nEnbs, uint32_t nUes, uint32_t nDedicatedBearers, std::list< CheckPointEvent > checkPointEventList, std::string checkPointEventListName, bool useUdp, std::string schedulerType, std::string handoverAlgorithmType, bool admitHo, bool useIdealRrc)
void Install(Ptr< Node > node) const
"Layout" a single node according to the current position allocator type.
store information on active data radio bearer instance
void SetHandoverAlgorithmAttribute(std::string n, const AttributeValue &v)
Set an attribute for the handover algorithm to be created.
Definition: lte-helper.cc:281
void AddTestCase(TestCase *testCase, enum TestDuration duration)
Add an individual child TestCase to this test suite.
Definition: test.cc:298
Create a client application which sends UDP packets carrying a 32bit sequence number and a 64 bit tim...
AttributeValue implementation for Time.
Definition: nstime.h:957
std::list< CheckPointEvent > m_checkPointEventList
Hold an unsigned integer type.
Definition: uinteger.h:44
double startTime
#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:161
holds a vector of ns3::NetDevice pointers
virtual void DoRun(void)
Implementation to actually run this TestCase.
void Start(Time start)
Arrange for all of the Applications in this container to Start() at the Time given as a parameter...
#define NS_LOG_LOGIC(msg)
Use NS_LOG to output a message of level LOG_LOGIC.
Definition: log.h:252
tuple serverApps
Definition: first.py:45
Access to the IPv4 forwarding table, interfaces, and configuration.
Definition: ipv4.h:76
uint16_t remotePortEnd
end of the port number range of the remote host
Definition: epc-tft.h:113
virtual Ipv4Address GetUeDefaultGatewayAddress()
static LteX2HandoverMeasuresTestSuite g_lteX2HandoverMeasuresTestSuiteInstance
Every class exported by the ns3 library is enclosed in the ns3 namespace.
keep track of a set of node pointers.
Ptr< Application > Get(uint32_t i) const
Get the Ptr stored in this container at a given index.
State
The state of the UeManager at the eNB RRC.
Definition: lte-enb-rrc.h:73
void SetMobilityModel(std::string type, std::string n1="", const AttributeValue &v1=EmptyAttributeValue(), std::string n2="", const AttributeValue &v2=EmptyAttributeValue(), std::string n3="", const AttributeValue &v3=EmptyAttributeValue(), std::string n4="", const AttributeValue &v4=EmptyAttributeValue(), std::string n5="", const AttributeValue &v5=EmptyAttributeValue(), std::string n6="", const AttributeValue &v6=EmptyAttributeValue(), std::string n7="", const AttributeValue &v7=EmptyAttributeValue(), std::string n8="", const AttributeValue &v8=EmptyAttributeValue(), std::string n9="", const AttributeValue &v9=EmptyAttributeValue())
double GetValue(double min, double max)
Get the next random value, as a double in the specified range .
void Install(std::string nodeName) const
Aggregate implementations of the ns3::Ipv4, ns3::Ipv6, ns3::Udp, and ns3::Tcp classes onto the provid...
void AddX2Interface(NodeContainer enbNodes)
Create an X2 interface between all the eNBs in a given set.
Definition: lte-helper.cc:976
Iterator Begin(void) const
Get an iterator to the first Object.
void GetAttribute(std::string name, AttributeValue &value) const
Get the value of an attribute, raising fatal errors if unsuccessful.
Definition: object-base.cc:229
uint64_t GetImsi(void) const
void Reset(void)
Reset the initial value of every attribute as well as the value of every global to what they were bef...
Definition: config.cc:749
static std::string BuildNameString(uint32_t nEnbs, uint32_t nUes, uint32_t nDedicatedBearers, std::string checkPointEventListName, bool useUdp, std::string schedulerType, std::string handoverAlgorithmType, bool admitHo, bool useIdealRrc)
void SetChannelAttribute(std::string name, const AttributeValue &value)
Set an attribute value to be propagated to each Channel created by the helper.
#define NS_ASSERT_MSG(condition, message)
At runtime, in debugging builds, if this condition is not true, the program prints the message to out...
Definition: assert.h:90
NetDeviceContainer InstallUeDevice(NodeContainer c)
Create a set of UE devices.
Definition: lte-helper.cc:397
virtual Ipv4InterfaceContainer AssignUeIpv4Address(NetDeviceContainer ueDevices)
Assign IPv4 addresses to UE devices.
Helper class used to assign positions and mobility models to nodes.
void AddNetworkRouteTo(Ipv4Address network, Ipv4Mask networkMask, Ipv4Address nextHop, uint32_t interface, uint32_t metric=0)
Add a network route to the static routing table.
Ipv4 addresses are stored in host order in this class.
Definition: ipv4-address.h:40
Ipv4InterfaceContainer Assign(const NetDeviceContainer &c)
Assign IP addresses to the net devices specified in the container based on the current network prefix...
Ptr< Ipv4StaticRouting > GetStaticRouting(Ptr< Ipv4 > ipv4) const
Try and find the static routing protocol as either the main routing protocol or in the list of routin...
void SetEpcHelper(Ptr< EpcHelper > h)
Set the EpcHelper to be used to setup the EPC network in conjunction with the setup of the LTE radio ...
Definition: lte-helper.cc:218
#define NS_TEST_ASSERT_MSG_NE(actual, limit, msg)
Test that an actual and expected (limit) value are not equal and report and abort if not...
Definition: test.h:617
Helper class that adds ns3::Ipv4StaticRouting objects.
AttributeValue implementation for DataRate.
Definition: data-rate.h:242
Ptr< Node > Get(uint32_t i) const
Get the Ptr stored in this container at a given index.
Iterator End(void) const
Get an iterator to the past-the-end Object.
std::vector< Ptr< NetDevice > >::const_iterator Iterator
NetDevice container iterator.
Time Seconds(double value)
Construct a Time in the indicated unit.
Definition: nstime.h:895
void SetDefault(std::string name, const AttributeValue &value)
Definition: config.cc:774
void Add(Vector v)
Add a position to the list of positions.
CheckPointEvent(Time start, Time stop, Time interval, uint32_t ueIndex, uint32_t enbIndex)
Mobility model for which the current speed does not change once it has been set and until it is set a...
ApplicationContainer Install(NodeContainer c) const
Install an ns3::PacketSinkApplication on each node of the input container configured with all the att...
A helper class to make life easier while doing simple IPv4 address assignment in scripts.
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)
Helper function used to set the underlying application attributes, not the socket attributes...
uint32_t GetN(void) const
Get the number of Objects.
Container for a set of ns3::Object pointers.
Receive and consume traffic generated to an IP address and port.
Definition: packet-sink.h:68
void SetPositionAllocator(Ptr< PositionAllocator > allocator)
Set the position allocator which will be used to allocate the initial position of every node initiali...
Iterator End(void) const
Get an iterator which indicates past-the-last NetDevice in the container.
#define NS_TEST_ASSERT_MSG_GT(actual, limit, msg)
Test that an actual value is greater than a limit and report and abort if not.
Definition: test.h:990
This class can be used to hold variables of floating point type such as 'double' or 'float'...
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:191
The eNodeB device implementation.
Qci
QoS Class Indicator.
Definition: eps-bearer.h:77
uint16_t remotePortStart
start of the port number range of the remote host
Definition: epc-tft.h:112
void CheckConnected(Ptr< NetDevice > ueDevice, Ptr< NetDevice > enbDevice)
void SetBase(Ipv4Address network, Ipv4Mask mask, Ipv4Address base="0.0.0.1")
Set the base network number, network mask and base address.
Implement the data structure representing a TrafficFlowTemplate Packet Filter.
Definition: epc-tft.h:73
Ipv4Address GetAddress(uint32_t i, uint32_t j=0) const
uint16_t localPortStart
start of the port number range of the UE
Definition: epc-tft.h:114
The LteUeNetDevice class implements the UE net device.