A Discrete-Event Network Simulator
API
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
lte-test-interference.cc
Go to the documentation of this file.
1 /* -*- Mode: C++; c-file-style: "gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2011 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  * Nicola Baldo <nbaldo@cttc.es>
20  */
21 
22 #include "ns3/simulator.h"
23 #include "ns3/log.h"
24 #include "ns3/string.h"
25 #include "ns3/double.h"
26 #include <ns3/enum.h>
27 #include "ns3/boolean.h"
28 #include "ns3/mobility-helper.h"
29 #include "ns3/lte-helper.h"
30 #include "ns3/ff-mac-scheduler.h"
31 
32 #include "ns3/lte-enb-phy.h"
33 #include "ns3/lte-enb-net-device.h"
34 
35 #include "ns3/lte-ue-phy.h"
36 #include "ns3/lte-ue-net-device.h"
37 
38 #include "lte-test-interference.h"
39 
40 #include "lte-test-sinr-chunk-processor.h"
41 
42 NS_LOG_COMPONENT_DEFINE ("LteInterferenceTest");
43 
44 namespace ns3 {
45 
46 
47 void
48 LteTestDlSchedulingCallback (LteInterferenceTestCase *testcase, std::string path,
49  uint32_t frameNo, uint32_t subframeNo, uint16_t rnti,
50  uint8_t mcsTb1, uint16_t sizeTb1, uint8_t mcsTb2, uint16_t sizeTb2)
51 {
52  testcase->DlScheduling (frameNo, subframeNo, rnti, mcsTb1, sizeTb1, mcsTb2, sizeTb2);
53 }
54 
55 void
56 LteTestUlSchedulingCallback (LteInterferenceTestCase *testcase, std::string path,
57  uint32_t frameNo, uint32_t subframeNo, uint16_t rnti,
58  uint8_t mcs, uint16_t sizeTb)
59 {
60  testcase->UlScheduling (frameNo, subframeNo, rnti, mcs, sizeTb);
61 }
62 
63 
68 LteInterferenceTestSuite::LteInterferenceTestSuite ()
69  : TestSuite ("lte-interference", SYSTEM)
70 {
71  AddTestCase (new LteInterferenceTestCase ("d1=3000, d2=6000", 3000.000000, 6000.000000, 3.844681, 1.714583, 0.761558, 0.389662, 6, 4), TestCase::QUICK);
72  AddTestCase (new LteInterferenceTestCase ("d1=50, d2=10", 50.000000, 10.000000, 0.040000, 0.040000, 0.010399, 0.010399, 0, 0), TestCase::QUICK);
73  AddTestCase (new LteInterferenceTestCase ("d1=50, d2=20", 50.000000, 20.000000, 0.160000, 0.159998, 0.041154, 0.041153, 0, 0), TestCase::QUICK);
74  AddTestCase (new LteInterferenceTestCase ("d1=50, d2=50", 50.000000, 50.000000, 0.999997, 0.999907, 0.239828, 0.239808, 2, 2), TestCase::QUICK);
75  AddTestCase (new LteInterferenceTestCase ("d1=50, d2=100", 50.000000, 100.000000, 3.999955, 3.998520, 0.785259, 0.785042, 6, 6), TestCase::QUICK);
76  AddTestCase (new LteInterferenceTestCase ("d1=50, d2=200", 50.000000, 200.000000, 15.999282, 15.976339, 1.961072, 1.959533, 14, 14), TestCase::QUICK);
77  AddTestCase (new LteInterferenceTestCase ("d1=50, d2=500", 50.000000, 500.000000, 99.971953, 99.082845, 4.254003, 4.241793, 22, 22), TestCase::QUICK);
78  AddTestCase (new LteInterferenceTestCase ("d1=50, d2=1000", 50.000000, 1000.000000, 399.551632, 385.718468, 6.194952, 6.144825, 28, 28), TestCase::QUICK);
79  AddTestCase (new LteInterferenceTestCase ("d1=50, d2=10000", 50.000000, 10000.000000, 35964.181431, 8505.970614, 12.667381, 10.588084, 28, 28), TestCase::QUICK);
80  AddTestCase (new LteInterferenceTestCase ("d1=50, d2=100000", 50.000000, 100000.000000, 327284.773828, 10774.181090, 15.853097, 10.928917, 28, 28), TestCase::QUICK);
81  AddTestCase (new LteInterferenceTestCase ("d1=50, d2=1000000", 50.000000, 1000000.000000, 356132.574152, 10802.988445, 15.974963, 10.932767, 28, 28), TestCase::QUICK);
82  AddTestCase (new LteInterferenceTestCase ("d1=4500, d2=12600", 4500.000000, 12600.000000, 6.654462, 1.139831, 1.139781, 0.270399, 8, 2), TestCase::QUICK);
83  AddTestCase (new LteInterferenceTestCase ("d1=5400, d2=12600", 5400.000000, 12600.000000, 4.621154, 0.791549, 0.876368, 0.193019, 6, 0), TestCase::QUICK);
84 
85 
86 }
87 
88 static LteInterferenceTestSuite lteLinkAdaptationWithInterferenceTestSuite;
89 
90 
95 LteInterferenceTestCase::LteInterferenceTestCase (std::string name, double d1, double d2, double dlSinr, double ulSinr, double dlSe, double ulSe, uint16_t dlMcs, uint16_t ulMcs)
96  : TestCase (name),
97  m_d1 (d1),
98  m_d2 (d2),
99  m_dlSinrDb (10 * std::log10 (dlSinr)),
100  m_ulSinrDb (10 * std::log10 (ulSinr)),
101  m_dlSe (dlSe),
102  m_ulSe (ulSe),
103  m_dlMcs (dlMcs),
104  m_ulMcs (ulMcs)
105 {
106 }
107 
108 LteInterferenceTestCase::~LteInterferenceTestCase ()
109 {
110 }
111 
112 void
113 LteInterferenceTestCase::DoRun (void)
114 {
115  NS_LOG_INFO (this << GetName ());
116 
117  Config::SetDefault ("ns3::LteSpectrumPhy::CtrlErrorModelEnabled", BooleanValue (false));
118  Config::SetDefault ("ns3::LteSpectrumPhy::DataErrorModelEnabled", BooleanValue (false));
119  Config::SetDefault ("ns3::LteAmc::AmcModel", EnumValue (LteAmc::PiroEW2010));
120  Config::SetDefault ("ns3::LteAmc::Ber", DoubleValue (0.00005));
121  Ptr<LteHelper> lteHelper = CreateObject<LteHelper> ();
122  lteHelper->SetAttribute ("PathlossModel", StringValue ("ns3::FriisSpectrumPropagationLossModel"));
123  lteHelper->SetAttribute ("UseIdealRrc", BooleanValue (false));
124 
125  // Create Nodes: eNodeB and UE
126  NodeContainer enbNodes;
127  NodeContainer ueNodes1;
128  NodeContainer ueNodes2;
129  enbNodes.Create (2);
130  ueNodes1.Create (1);
131  ueNodes2.Create (1);
132  NodeContainer allNodes = NodeContainer ( enbNodes, ueNodes1, ueNodes2);
133 
134  // the topology is the following:
135  // d2
136  // UE1-----------eNB2
137  // | |
138  // d1| |d1
139  // | d2 |
140  // eNB1----------UE2
141  //
142  Ptr<ListPositionAllocator> positionAlloc = CreateObject<ListPositionAllocator> ();
143  positionAlloc->Add (Vector (0.0, 0.0, 0.0)); // eNB1
144  positionAlloc->Add (Vector (m_d2, m_d1, 0.0)); // eNB2
145  positionAlloc->Add (Vector (0.0, m_d1, 0.0)); // UE1
146  positionAlloc->Add (Vector (m_d2, 0.0, 0.0)); // UE2
147  MobilityHelper mobility;
148  mobility.SetMobilityModel ("ns3::ConstantPositionMobilityModel");
149  mobility.SetPositionAllocator (positionAlloc);
150  mobility.Install (allNodes);
151 
152  // Create Devices and install them in the Nodes (eNB and UE)
153  NetDeviceContainer enbDevs;
154  NetDeviceContainer ueDevs1;
155  NetDeviceContainer ueDevs2;
156  lteHelper->SetSchedulerType ("ns3::RrFfMacScheduler");
157  lteHelper->SetSchedulerAttribute ("UlCqiFilter", EnumValue (FfMacScheduler::PUSCH_UL_CQI));
158  enbDevs = lteHelper->InstallEnbDevice (enbNodes);
159  ueDevs1 = lteHelper->InstallUeDevice (ueNodes1);
160  ueDevs2 = lteHelper->InstallUeDevice (ueNodes2);
161 
162  lteHelper->Attach (ueDevs1, enbDevs.Get (0));
163  lteHelper->Attach (ueDevs2, enbDevs.Get (1));
164 
165  // Activate an EPS bearer
166  enum EpsBearer::Qci q = EpsBearer::GBR_CONV_VOICE;
167  EpsBearer bearer (q);
168  lteHelper->ActivateDataRadioBearer (ueDevs1, bearer);
169  lteHelper->ActivateDataRadioBearer (ueDevs2, bearer);
170 
171  // Use testing chunk processor in the PHY layer
172  // It will be used to test that the SNR is as intended
173  // we plug in two instances, one for DL and one for UL
174 
175  Ptr<LtePhy> ue1Phy = ueDevs1.Get (0)->GetObject<LteUeNetDevice> ()->GetPhy ()->GetObject<LtePhy> ();
176  Ptr<LteTestSinrChunkProcessor> testDlSinr1 = Create<LteTestSinrChunkProcessor> (ue1Phy);
177  ue1Phy->GetDownlinkSpectrumPhy ()->AddDataSinrChunkProcessor (testDlSinr1);
178 
179  Ptr<LtePhy> enb1phy = enbDevs.Get (0)->GetObject<LteEnbNetDevice> ()->GetPhy ()->GetObject<LtePhy> ();
180  Ptr<LteTestSinrChunkProcessor> testUlSinr1 = Create<LteTestSinrChunkProcessor> (enb1phy);
181  enb1phy->GetUplinkSpectrumPhy ()->AddDataSinrChunkProcessor (testUlSinr1);
182 
183  Config::Connect ("/NodeList/0/DeviceList/0/LteEnbMac/DlScheduling",
184  MakeBoundCallback (&LteTestDlSchedulingCallback, this));
185 
186  Config::Connect ("/NodeList/0/DeviceList/0/LteEnbMac/UlScheduling",
187  MakeBoundCallback (&LteTestUlSchedulingCallback, this));
188 
189 
190  // same as above for eNB2 and UE2
191 
192  Ptr<LtePhy> ue2Phy = ueDevs2.Get (0)->GetObject<LteUeNetDevice> ()->GetPhy ()->GetObject<LtePhy> ();
193  Ptr<LteTestSinrChunkProcessor> testDlSinr2 = Create<LteTestSinrChunkProcessor> (ue2Phy);
194  ue2Phy->GetDownlinkSpectrumPhy ()->AddDataSinrChunkProcessor (testDlSinr2);
195 
196  Ptr<LtePhy> enb2phy = enbDevs.Get (1)->GetObject<LteEnbNetDevice> ()->GetPhy ()->GetObject<LtePhy> ();
197  Ptr<LteTestSinrChunkProcessor> testUlSinr2 = Create<LteTestSinrChunkProcessor> (enb2phy);
198  enb1phy->GetUplinkSpectrumPhy ()->AddDataSinrChunkProcessor (testUlSinr2);
199 
200  Config::Connect ("/NodeList/1/DeviceList/0/LteEnbMac/DlScheduling",
201  MakeBoundCallback (&LteTestDlSchedulingCallback, this));
202 
203  Config::Connect ("/NodeList/1/DeviceList/0/LteEnbMac/UlScheduling",
204  MakeBoundCallback (&LteTestUlSchedulingCallback, this));
205 
206 // need to allow for RRC connection establishment + SRS
207  Simulator::Stop (Seconds (0.100));
208  Simulator::Run ();
209 
210  if (m_dlMcs > 0)
211  {
212  double dlSinr1Db = 10.0 * std::log10 (testDlSinr1->GetSinr ()->operator[] (0));
213  NS_TEST_ASSERT_MSG_EQ_TOL (dlSinr1Db, m_dlSinrDb, 0.01, "Wrong SINR in DL! (eNB1 --> UE1)");
214 
215  double dlSinr2Db = 10.0 * std::log10 (testDlSinr2->GetSinr ()->operator[] (0));
216  NS_TEST_ASSERT_MSG_EQ_TOL (dlSinr2Db, m_dlSinrDb, 0.01, "Wrong SINR in DL! (eNB2 --> UE2)");
217  }
218  if (m_ulMcs > 0)
219  {
220  double ulSinr1Db = 10.0 * std::log10 (testUlSinr1->GetSinr ()->operator[] (0));
221  NS_TEST_ASSERT_MSG_EQ_TOL (ulSinr1Db, m_ulSinrDb, 0.01, "Wrong SINR in UL! (UE1 --> eNB1)");
222 
223  double ulSinr2Db = 10.0 * std::log10 (testUlSinr2->GetSinr ()->operator[] (0));
224  NS_TEST_ASSERT_MSG_EQ_TOL (ulSinr2Db, m_ulSinrDb, 0.01, "Wrong SINR in UL! (UE2 --> eNB2)");
225  }
226 
227  Simulator::Destroy ();
228 
229 }
230 
231 
232 void
233 LteInterferenceTestCase::DlScheduling (uint32_t frameNo, uint32_t subframeNo, uint16_t rnti,
234  uint8_t mcsTb1, uint16_t sizeTb1, uint8_t mcsTb2, uint16_t sizeTb2)
235 {
236  // need to allow for RRC connection establishment + CQI feedback reception
237  if (Simulator::Now () > MilliSeconds (35))
238  {
239  NS_TEST_ASSERT_MSG_EQ ((uint32_t)mcsTb1, (uint32_t)m_dlMcs, "Wrong DL MCS ");
240  }
241 }
242 
243 void
244 LteInterferenceTestCase::UlScheduling (uint32_t frameNo, uint32_t subframeNo, uint16_t rnti,
245  uint8_t mcs, uint16_t sizeTb)
246 {
247  // need to allow for RRC connection establishment + SRS transmission
248  if (Simulator::Now () > MilliSeconds (50))
249  {
250  NS_TEST_ASSERT_MSG_EQ ((uint32_t)mcs, (uint32_t)m_ulMcs, "Wrong UL MCS");
251  }
252 }
253 
254 } // namespace ns3
255