A Discrete-Event Network Simulator
API
fdmt-ff-mac-scheduler.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: Marco Miozzo <marco.miozzo@cttc.es>
19  * Modification: Dizhi Zhou <dizhi.zhou@gmail.com> // modify codes related to downlink scheduler
20  */
21 
22 #include <ns3/log.h>
23 #include <ns3/pointer.h>
24 #include <ns3/math.h>
25 
26 #include <ns3/simulator.h>
27 #include <ns3/lte-amc.h>
28 #include <ns3/fdmt-ff-mac-scheduler.h>
29 #include <ns3/lte-vendor-specific-parameters.h>
30 #include <ns3/boolean.h>
31 #include <set>
32 #include <cfloat>
33 
34 namespace ns3 {
35 
36 NS_LOG_COMPONENT_DEFINE ("FdMtFfMacScheduler");
37 
39 static const int FdMtType0AllocationRbg[4] = {
40  10, // RGB size 1
41  26, // RGB size 2
42  63, // RGB size 3
43  110 // RGB size 4
44 }; // see table 7.1.6.1-1 of 36.213
45 
46 
47 NS_OBJECT_ENSURE_REGISTERED (FdMtFfMacScheduler);
48 
49 
50 
52  : m_cschedSapUser (0),
53  m_schedSapUser (0),
54  m_nextRntiUl (0)
55 {
56  m_amc = CreateObject <LteAmc> ();
59 }
60 
62 {
63  NS_LOG_FUNCTION (this);
64 }
65 
66 void
68 {
69  NS_LOG_FUNCTION (this);
71  m_dlHarqProcessesTimer.clear ();
73  m_dlInfoListBuffered.clear ();
74  m_ulHarqCurrentProcessId.clear ();
75  m_ulHarqProcessesStatus.clear ();
77  delete m_cschedSapProvider;
78  delete m_schedSapProvider;
79 }
80 
81 TypeId
83 {
84  static TypeId tid = TypeId ("ns3::FdMtFfMacScheduler")
86  .SetGroupName("Lte")
87  .AddConstructor<FdMtFfMacScheduler> ()
88  .AddAttribute ("CqiTimerThreshold",
89  "The number of TTIs a CQI is valid (default 1000 - 1 sec.)",
90  UintegerValue (1000),
92  MakeUintegerChecker<uint32_t> ())
93  .AddAttribute ("HarqEnabled",
94  "Activate/Deactivate the HARQ [by default is active].",
95  BooleanValue (true),
98  .AddAttribute ("UlGrantMcs",
99  "The MCS of the UL grant, must be [0..15] (default 0)",
100  UintegerValue (0),
102  MakeUintegerChecker<uint8_t> ())
103  ;
104  return tid;
105 }
106 
107 
108 
109 void
111 {
112  m_cschedSapUser = s;
113 }
114 
115 void
117 {
118  m_schedSapUser = s;
119 }
120 
123 {
124  return m_cschedSapProvider;
125 }
126 
129 {
130  return m_schedSapProvider;
131 }
132 
133 void
135 {
136  m_ffrSapProvider = s;
137 }
138 
141 {
142  return m_ffrSapUser;
143 }
144 
145 void
147 {
148  NS_LOG_FUNCTION (this);
149  // Read the subset of parameters used
150  m_cschedCellConfig = params;
153  cnf.m_result = SUCCESS;
155  return;
156 }
157 
158 void
160 {
161  NS_LOG_FUNCTION (this << " RNTI " << params.m_rnti << " txMode " << (uint16_t)params.m_transmissionMode);
162  std::map <uint16_t,uint8_t>::iterator it = m_uesTxMode.find (params.m_rnti);
163  if (it == m_uesTxMode.end ())
164  {
165  m_uesTxMode.insert (std::pair <uint16_t, double> (params.m_rnti, params.m_transmissionMode));
166  // generate HARQ buffers
167  m_dlHarqCurrentProcessId.insert (std::pair <uint16_t,uint8_t > (params.m_rnti, 0));
168  DlHarqProcessesStatus_t dlHarqPrcStatus;
169  dlHarqPrcStatus.resize (8,0);
170  m_dlHarqProcessesStatus.insert (std::pair <uint16_t, DlHarqProcessesStatus_t> (params.m_rnti, dlHarqPrcStatus));
171  DlHarqProcessesTimer_t dlHarqProcessesTimer;
172  dlHarqProcessesTimer.resize (8,0);
173  m_dlHarqProcessesTimer.insert (std::pair <uint16_t, DlHarqProcessesTimer_t> (params.m_rnti, dlHarqProcessesTimer));
174  DlHarqProcessesDciBuffer_t dlHarqdci;
175  dlHarqdci.resize (8);
176  m_dlHarqProcessesDciBuffer.insert (std::pair <uint16_t, DlHarqProcessesDciBuffer_t> (params.m_rnti, dlHarqdci));
177  DlHarqRlcPduListBuffer_t dlHarqRlcPdu;
178  dlHarqRlcPdu.resize (2);
179  dlHarqRlcPdu.at (0).resize (8);
180  dlHarqRlcPdu.at (1).resize (8);
181  m_dlHarqProcessesRlcPduListBuffer.insert (std::pair <uint16_t, DlHarqRlcPduListBuffer_t> (params.m_rnti, dlHarqRlcPdu));
182  m_ulHarqCurrentProcessId.insert (std::pair <uint16_t,uint8_t > (params.m_rnti, 0));
183  UlHarqProcessesStatus_t ulHarqPrcStatus;
184  ulHarqPrcStatus.resize (8,0);
185  m_ulHarqProcessesStatus.insert (std::pair <uint16_t, UlHarqProcessesStatus_t> (params.m_rnti, ulHarqPrcStatus));
186  UlHarqProcessesDciBuffer_t ulHarqdci;
187  ulHarqdci.resize (8);
188  m_ulHarqProcessesDciBuffer.insert (std::pair <uint16_t, UlHarqProcessesDciBuffer_t> (params.m_rnti, ulHarqdci));
189  }
190  else
191  {
192  (*it).second = params.m_transmissionMode;
193  }
194  return;
195 }
196 
197 void
199 {
200  NS_LOG_FUNCTION (this << " New LC, rnti: " << params.m_rnti);
201 
202  std::set <uint16_t>::iterator it;
203  for (uint16_t i = 0; i < params.m_logicalChannelConfigList.size (); i++)
204  {
205  it = m_flowStatsDl.find (params.m_rnti);
206 
207  if (it == m_flowStatsDl.end ())
208  {
209  m_flowStatsDl.insert (params.m_rnti);
210  m_flowStatsUl.insert (params.m_rnti);
211  }
212  }
213 
214  return;
215 }
216 
217 void
219 {
220  NS_LOG_FUNCTION (this);
221  for (uint16_t i = 0; i < params.m_logicalChannelIdentity.size (); i++)
222  {
223  std::map<LteFlowId_t, FfMacSchedSapProvider::SchedDlRlcBufferReqParameters>::iterator it = m_rlcBufferReq.begin ();
224  std::map<LteFlowId_t, FfMacSchedSapProvider::SchedDlRlcBufferReqParameters>::iterator temp;
225  while (it!=m_rlcBufferReq.end ())
226  {
227  if (((*it).first.m_rnti == params.m_rnti) && ((*it).first.m_lcId == params.m_logicalChannelIdentity.at (i)))
228  {
229  temp = it;
230  it++;
231  m_rlcBufferReq.erase (temp);
232  }
233  else
234  {
235  it++;
236  }
237  }
238  }
239  return;
240 }
241 
242 void
244 {
245  NS_LOG_FUNCTION (this);
246 
247  m_uesTxMode.erase (params.m_rnti);
248  m_dlHarqCurrentProcessId.erase (params.m_rnti);
249  m_dlHarqProcessesStatus.erase (params.m_rnti);
250  m_dlHarqProcessesTimer.erase (params.m_rnti);
251  m_dlHarqProcessesDciBuffer.erase (params.m_rnti);
253  m_ulHarqCurrentProcessId.erase (params.m_rnti);
254  m_ulHarqProcessesStatus.erase (params.m_rnti);
255  m_ulHarqProcessesDciBuffer.erase (params.m_rnti);
256  m_flowStatsDl.erase (params.m_rnti);
257  m_flowStatsUl.erase (params.m_rnti);
258  m_ceBsrRxed.erase (params.m_rnti);
259  std::map<LteFlowId_t, FfMacSchedSapProvider::SchedDlRlcBufferReqParameters>::iterator it = m_rlcBufferReq.begin ();
260  std::map<LteFlowId_t, FfMacSchedSapProvider::SchedDlRlcBufferReqParameters>::iterator temp;
261  while (it!=m_rlcBufferReq.end ())
262  {
263  if ((*it).first.m_rnti == params.m_rnti)
264  {
265  temp = it;
266  it++;
267  m_rlcBufferReq.erase (temp);
268  }
269  else
270  {
271  it++;
272  }
273  }
274  if (m_nextRntiUl == params.m_rnti)
275  {
276  m_nextRntiUl = 0;
277  }
278 
279  return;
280 }
281 
282 
283 void
285 {
286  NS_LOG_FUNCTION (this << params.m_rnti << (uint32_t) params.m_logicalChannelIdentity);
287  // API generated by RLC for updating RLC parameters on a LC (tx and retx queues)
288 
289  std::map <LteFlowId_t, FfMacSchedSapProvider::SchedDlRlcBufferReqParameters>::iterator it;
290 
291  LteFlowId_t flow (params.m_rnti, params.m_logicalChannelIdentity);
292 
293  it = m_rlcBufferReq.find (flow);
294 
295  if (it == m_rlcBufferReq.end ())
296  {
297  m_rlcBufferReq.insert (std::pair <LteFlowId_t, FfMacSchedSapProvider::SchedDlRlcBufferReqParameters> (flow, params));
298  }
299  else
300  {
301  (*it).second = params;
302  }
303 
304  return;
305 }
306 
307 void
309 {
310  NS_LOG_FUNCTION (this);
311  NS_FATAL_ERROR ("method not implemented");
312  return;
313 }
314 
315 void
317 {
318  NS_LOG_FUNCTION (this);
319  NS_FATAL_ERROR ("method not implemented");
320  return;
321 }
322 
323 int
325 {
326  for (int i = 0; i < 4; i++)
327  {
328  if (dlbandwidth < FdMtType0AllocationRbg[i])
329  {
330  return (i + 1);
331  }
332  }
333 
334  return (-1);
335 }
336 
337 
338 unsigned int
340 {
341  std::map <LteFlowId_t, FfMacSchedSapProvider::SchedDlRlcBufferReqParameters>::iterator it;
342  unsigned int lcActive = 0;
343  for (it = m_rlcBufferReq.begin (); it != m_rlcBufferReq.end (); it++)
344  {
345  if (((*it).first.m_rnti == rnti) && (((*it).second.m_rlcTransmissionQueueSize > 0)
346  || ((*it).second.m_rlcRetransmissionQueueSize > 0)
347  || ((*it).second.m_rlcStatusPduSize > 0) ))
348  {
349  lcActive++;
350  }
351  if ((*it).first.m_rnti > rnti)
352  {
353  break;
354  }
355  }
356  return (lcActive);
357 
358 }
359 
360 
361 uint8_t
363 {
364  NS_LOG_FUNCTION (this << rnti);
365 
366  std::map <uint16_t, uint8_t>::iterator it = m_dlHarqCurrentProcessId.find (rnti);
367  if (it == m_dlHarqCurrentProcessId.end ())
368  {
369  NS_FATAL_ERROR ("No Process Id found for this RNTI " << rnti);
370  }
371  std::map <uint16_t, DlHarqProcessesStatus_t>::iterator itStat = m_dlHarqProcessesStatus.find (rnti);
372  if (itStat == m_dlHarqProcessesStatus.end ())
373  {
374  NS_FATAL_ERROR ("No Process Id Statusfound for this RNTI " << rnti);
375  }
376  uint8_t i = (*it).second;
377  do
378  {
379  i = (i + 1) % HARQ_PROC_NUM;
380  }
381  while ( ((*itStat).second.at (i) != 0)&&(i != (*it).second));
382  if ((*itStat).second.at (i) == 0)
383  {
384  return (true);
385  }
386  else
387  {
388  return (false); // return a not valid harq proc id
389  }
390 }
391 
392 
393 
394 uint8_t
396 {
397  NS_LOG_FUNCTION (this << rnti);
398 
399  if (m_harqOn == false)
400  {
401  return (0);
402  }
403 
404 
405  std::map <uint16_t, uint8_t>::iterator it = m_dlHarqCurrentProcessId.find (rnti);
406  if (it == m_dlHarqCurrentProcessId.end ())
407  {
408  NS_FATAL_ERROR ("No Process Id found for this RNTI " << rnti);
409  }
410  std::map <uint16_t, DlHarqProcessesStatus_t>::iterator itStat = m_dlHarqProcessesStatus.find (rnti);
411  if (itStat == m_dlHarqProcessesStatus.end ())
412  {
413  NS_FATAL_ERROR ("No Process Id Statusfound for this RNTI " << rnti);
414  }
415  uint8_t i = (*it).second;
416  do
417  {
418  i = (i + 1) % HARQ_PROC_NUM;
419  }
420  while ( ((*itStat).second.at (i) != 0)&&(i != (*it).second));
421  if ((*itStat).second.at (i) == 0)
422  {
423  (*it).second = i;
424  (*itStat).second.at (i) = 1;
425  }
426  else
427  {
428  NS_FATAL_ERROR ("No HARQ process available for RNTI " << rnti << " check before update with HarqProcessAvailability");
429  }
430 
431  return ((*it).second);
432 }
433 
434 
435 void
437 {
438  NS_LOG_FUNCTION (this);
439 
440  std::map <uint16_t, DlHarqProcessesTimer_t>::iterator itTimers;
441  for (itTimers = m_dlHarqProcessesTimer.begin (); itTimers != m_dlHarqProcessesTimer.end (); itTimers ++)
442  {
443  for (uint16_t i = 0; i < HARQ_PROC_NUM; i++)
444  {
445  if ((*itTimers).second.at (i) == HARQ_DL_TIMEOUT)
446  {
447  // reset HARQ process
448 
449  NS_LOG_DEBUG (this << " Reset HARQ proc " << i << " for RNTI " << (*itTimers).first);
450  std::map <uint16_t, DlHarqProcessesStatus_t>::iterator itStat = m_dlHarqProcessesStatus.find ((*itTimers).first);
451  if (itStat == m_dlHarqProcessesStatus.end ())
452  {
453  NS_FATAL_ERROR ("No Process Id Status found for this RNTI " << (*itTimers).first);
454  }
455  (*itStat).second.at (i) = 0;
456  (*itTimers).second.at (i) = 0;
457  }
458  else
459  {
460  (*itTimers).second.at (i)++;
461  }
462  }
463  }
464 
465 }
466 
467 
468 void
470 {
471  NS_LOG_FUNCTION (this << " Frame no. " << (params.m_sfnSf >> 4) << " subframe no. " << (0xF & params.m_sfnSf));
472  // API generated by RLC for triggering the scheduling of a DL subframe
473 
474 
475  // evaluate the relative channel quality indicator for each UE per each RBG
476  // (since we are using allocation type 0 the small unit of allocation is RBG)
477  // Resource allocation type 0 (see sec 7.1.6.1 of 36.213)
478 
479  RefreshDlCqiMaps ();
480 
482  int rbgNum = m_cschedCellConfig.m_dlBandwidth / rbgSize;
483  std::map <uint16_t, std::vector <uint16_t> > allocationMap; // RBs map per RNTI
484  std::vector <bool> rbgMap; // global RBGs map
485  uint16_t rbgAllocatedNum = 0;
486  std::set <uint16_t> rntiAllocated;
487  rbgMap.resize (m_cschedCellConfig.m_dlBandwidth / rbgSize, false);
489 
490  // update UL HARQ proc id
491  std::map <uint16_t, uint8_t>::iterator itProcId;
492  for (itProcId = m_ulHarqCurrentProcessId.begin (); itProcId != m_ulHarqCurrentProcessId.end (); itProcId++)
493  {
494  (*itProcId).second = ((*itProcId).second + 1) % HARQ_PROC_NUM;
495  }
496 
497  // RACH Allocation
499  uint16_t rbStart = 0;
500  std::vector <struct RachListElement_s>::iterator itRach;
501  for (itRach = m_rachList.begin (); itRach != m_rachList.end (); itRach++)
502  {
503  NS_ASSERT_MSG (m_amc->GetTbSizeFromMcs (m_ulGrantMcs, m_cschedCellConfig.m_ulBandwidth) > (*itRach).m_estimatedSize, " Default UL Grant MCS does not allow to send RACH messages");
504  BuildRarListElement_s newRar;
505  newRar.m_rnti = (*itRach).m_rnti;
506  // DL-RACH Allocation
507  // Ideal: no needs of configuring m_dci
508  // UL-RACH Allocation
509  newRar.m_grant.m_rnti = newRar.m_rnti;
510  newRar.m_grant.m_mcs = m_ulGrantMcs;
511  uint16_t rbLen = 1;
512  uint16_t tbSizeBits = 0;
513  // find lowest TB size that fits UL grant estimated size
514  while ((tbSizeBits < (*itRach).m_estimatedSize) && (rbStart + rbLen < m_cschedCellConfig.m_ulBandwidth))
515  {
516  rbLen++;
517  tbSizeBits = m_amc->GetTbSizeFromMcs (m_ulGrantMcs, rbLen);
518  }
519  if (tbSizeBits < (*itRach).m_estimatedSize)
520  {
521  // no more allocation space: finish allocation
522  break;
523  }
524  newRar.m_grant.m_rbStart = rbStart;
525  newRar.m_grant.m_rbLen = rbLen;
526  newRar.m_grant.m_tbSize = tbSizeBits / 8;
527  newRar.m_grant.m_hopping = false;
528  newRar.m_grant.m_tpc = 0;
529  newRar.m_grant.m_cqiRequest = false;
530  newRar.m_grant.m_ulDelay = false;
531  NS_LOG_INFO (this << " UL grant allocated to RNTI " << (*itRach).m_rnti << " rbStart " << rbStart << " rbLen " << rbLen << " MCS " << m_ulGrantMcs << " tbSize " << newRar.m_grant.m_tbSize);
532  for (uint16_t i = rbStart; i < rbStart + rbLen; i++)
533  {
534  m_rachAllocationMap.at (i) = (*itRach).m_rnti;
535  }
536 
537  if (m_harqOn == true)
538  {
539  // generate UL-DCI for HARQ retransmissions
540  UlDciListElement_s uldci;
541  uldci.m_rnti = newRar.m_rnti;
542  uldci.m_rbLen = rbLen;
543  uldci.m_rbStart = rbStart;
544  uldci.m_mcs = m_ulGrantMcs;
545  uldci.m_tbSize = tbSizeBits / 8;
546  uldci.m_ndi = 1;
547  uldci.m_cceIndex = 0;
548  uldci.m_aggrLevel = 1;
549  uldci.m_ueTxAntennaSelection = 3; // antenna selection OFF
550  uldci.m_hopping = false;
551  uldci.m_n2Dmrs = 0;
552  uldci.m_tpc = 0; // no power control
553  uldci.m_cqiRequest = false; // only period CQI at this stage
554  uldci.m_ulIndex = 0; // TDD parameter
555  uldci.m_dai = 1; // TDD parameter
556  uldci.m_freqHopping = 0;
557  uldci.m_pdcchPowerOffset = 0; // not used
558 
559  uint8_t harqId = 0;
560  std::map <uint16_t, uint8_t>::iterator itProcId;
561  itProcId = m_ulHarqCurrentProcessId.find (uldci.m_rnti);
562  if (itProcId == m_ulHarqCurrentProcessId.end ())
563  {
564  NS_FATAL_ERROR ("No info find in HARQ buffer for UE " << uldci.m_rnti);
565  }
566  harqId = (*itProcId).second;
567  std::map <uint16_t, UlHarqProcessesDciBuffer_t>::iterator itDci = m_ulHarqProcessesDciBuffer.find (uldci.m_rnti);
568  if (itDci == m_ulHarqProcessesDciBuffer.end ())
569  {
570  NS_FATAL_ERROR ("Unable to find RNTI entry in UL DCI HARQ buffer for RNTI " << uldci.m_rnti);
571  }
572  (*itDci).second.at (harqId) = uldci;
573  }
574 
575  rbStart = rbStart + rbLen;
576  ret.m_buildRarList.push_back (newRar);
577  }
578  m_rachList.clear ();
579 
580 
581  // Process DL HARQ feedback
583  // retrieve past HARQ retx buffered
584  if (m_dlInfoListBuffered.size () > 0)
585  {
586  if (params.m_dlInfoList.size () > 0)
587  {
588  NS_LOG_INFO (this << " Received DL-HARQ feedback");
589  m_dlInfoListBuffered.insert (m_dlInfoListBuffered.end (), params.m_dlInfoList.begin (), params.m_dlInfoList.end ());
590  }
591  }
592  else
593  {
594  if (params.m_dlInfoList.size () > 0)
595  {
597  }
598  }
599  if (m_harqOn == false)
600  {
601  // Ignore HARQ feedback
602  m_dlInfoListBuffered.clear ();
603  }
604  std::vector <struct DlInfoListElement_s> dlInfoListUntxed;
605  for (uint16_t i = 0; i < m_dlInfoListBuffered.size (); i++)
606  {
607  std::set <uint16_t>::iterator itRnti = rntiAllocated.find (m_dlInfoListBuffered.at (i).m_rnti);
608  if (itRnti != rntiAllocated.end ())
609  {
610  // RNTI already allocated for retx
611  continue;
612  }
613  uint8_t nLayers = m_dlInfoListBuffered.at (i).m_harqStatus.size ();
614  std::vector <bool> retx;
615  NS_LOG_INFO (this << " Processing DLHARQ feedback");
616  if (nLayers == 1)
617  {
618  retx.push_back (m_dlInfoListBuffered.at (i).m_harqStatus.at (0) == DlInfoListElement_s::NACK);
619  retx.push_back (false);
620  }
621  else
622  {
623  retx.push_back (m_dlInfoListBuffered.at (i).m_harqStatus.at (0) == DlInfoListElement_s::NACK);
624  retx.push_back (m_dlInfoListBuffered.at (i).m_harqStatus.at (1) == DlInfoListElement_s::NACK);
625  }
626  if (retx.at (0) || retx.at (1))
627  {
628  // retrieve HARQ process information
629  uint16_t rnti = m_dlInfoListBuffered.at (i).m_rnti;
630  uint8_t harqId = m_dlInfoListBuffered.at (i).m_harqProcessId;
631  NS_LOG_INFO (this << " HARQ retx RNTI " << rnti << " harqId " << (uint16_t)harqId);
632  std::map <uint16_t, DlHarqProcessesDciBuffer_t>::iterator itHarq = m_dlHarqProcessesDciBuffer.find (rnti);
633  if (itHarq == m_dlHarqProcessesDciBuffer.end ())
634  {
635  NS_FATAL_ERROR ("No info find in HARQ buffer for UE " << rnti);
636  }
637 
638  DlDciListElement_s dci = (*itHarq).second.at (harqId);
639  int rv = 0;
640  if (dci.m_rv.size () == 1)
641  {
642  rv = dci.m_rv.at (0);
643  }
644  else
645  {
646  rv = (dci.m_rv.at (0) > dci.m_rv.at (1) ? dci.m_rv.at (0) : dci.m_rv.at (1));
647  }
648 
649  if (rv == 3)
650  {
651  // maximum number of retx reached -> drop process
652  NS_LOG_INFO ("Maximum number of retransmissions reached -> drop process");
653  std::map <uint16_t, DlHarqProcessesStatus_t>::iterator it = m_dlHarqProcessesStatus.find (rnti);
654  if (it == m_dlHarqProcessesStatus.end ())
655  {
656  NS_LOG_ERROR ("No info find in HARQ buffer for UE (might change eNB) " << m_dlInfoListBuffered.at (i).m_rnti);
657  }
658  (*it).second.at (harqId) = 0;
659  std::map <uint16_t, DlHarqRlcPduListBuffer_t>::iterator itRlcPdu = m_dlHarqProcessesRlcPduListBuffer.find (rnti);
660  if (itRlcPdu == m_dlHarqProcessesRlcPduListBuffer.end ())
661  {
662  NS_FATAL_ERROR ("Unable to find RlcPdcList in HARQ buffer for RNTI " << m_dlInfoListBuffered.at (i).m_rnti);
663  }
664  for (uint16_t k = 0; k < (*itRlcPdu).second.size (); k++)
665  {
666  (*itRlcPdu).second.at (k).at (harqId).clear ();
667  }
668  continue;
669  }
670  // check the feasibility of retransmitting on the same RBGs
671  // translate the DCI to Spectrum framework
672  std::vector <int> dciRbg;
673  uint32_t mask = 0x1;
674  NS_LOG_INFO ("Original RBGs " << dci.m_rbBitmap << " rnti " << dci.m_rnti);
675  for (int j = 0; j < 32; j++)
676  {
677  if (((dci.m_rbBitmap & mask) >> j) == 1)
678  {
679  dciRbg.push_back (j);
680  NS_LOG_INFO ("\t" << j);
681  }
682  mask = (mask << 1);
683  }
684  bool free = true;
685  for (uint8_t j = 0; j < dciRbg.size (); j++)
686  {
687  if (rbgMap.at (dciRbg.at (j)) == true)
688  {
689  free = false;
690  break;
691  }
692  }
693  if (free)
694  {
695  // use the same RBGs for the retx
696  // reserve RBGs
697  for (uint8_t j = 0; j < dciRbg.size (); j++)
698  {
699  rbgMap.at (dciRbg.at (j)) = true;
700  NS_LOG_INFO ("RBG " << dciRbg.at (j) << " assigned");
701  rbgAllocatedNum++;
702  }
703 
704  NS_LOG_INFO (this << " Send retx in the same RBGs");
705  }
706  else
707  {
708  // find RBGs for sending HARQ retx
709  uint8_t j = 0;
710  uint8_t rbgId = (dciRbg.at (dciRbg.size () - 1) + 1) % rbgNum;
711  uint8_t startRbg = dciRbg.at (dciRbg.size () - 1);
712  std::vector <bool> rbgMapCopy = rbgMap;
713  while ((j < dciRbg.size ())&&(startRbg != rbgId))
714  {
715  if (rbgMapCopy.at (rbgId) == false)
716  {
717  rbgMapCopy.at (rbgId) = true;
718  dciRbg.at (j) = rbgId;
719  j++;
720  }
721  rbgId = (rbgId + 1) % rbgNum;
722  }
723  if (j == dciRbg.size ())
724  {
725  // find new RBGs -> update DCI map
726  uint32_t rbgMask = 0;
727  for (uint16_t k = 0; k < dciRbg.size (); k++)
728  {
729  rbgMask = rbgMask + (0x1 << dciRbg.at (k));
730  rbgAllocatedNum++;
731  }
732  dci.m_rbBitmap = rbgMask;
733  rbgMap = rbgMapCopy;
734  NS_LOG_INFO (this << " Move retx in RBGs " << dciRbg.size ());
735  }
736  else
737  {
738  // HARQ retx cannot be performed on this TTI -> store it
739  dlInfoListUntxed.push_back (m_dlInfoListBuffered.at (i));
740  NS_LOG_INFO (this << " No resource for this retx -> buffer it");
741  }
742  }
743  // retrieve RLC PDU list for retx TBsize and update DCI
745  std::map <uint16_t, DlHarqRlcPduListBuffer_t>::iterator itRlcPdu = m_dlHarqProcessesRlcPduListBuffer.find (rnti);
746  if (itRlcPdu == m_dlHarqProcessesRlcPduListBuffer.end ())
747  {
748  NS_FATAL_ERROR ("Unable to find RlcPdcList in HARQ buffer for RNTI " << rnti);
749  }
750  for (uint8_t j = 0; j < nLayers; j++)
751  {
752  if (retx.at (j))
753  {
754  if (j >= dci.m_ndi.size ())
755  {
756  // for avoiding errors in MIMO transient phases
757  dci.m_ndi.push_back (0);
758  dci.m_rv.push_back (0);
759  dci.m_mcs.push_back (0);
760  dci.m_tbsSize.push_back (0);
761  NS_LOG_INFO (this << " layer " << (uint16_t)j << " no txed (MIMO transition)");
762  }
763  else
764  {
765  dci.m_ndi.at (j) = 0;
766  dci.m_rv.at (j)++;
767  (*itHarq).second.at (harqId).m_rv.at (j)++;
768  NS_LOG_INFO (this << " layer " << (uint16_t)j << " RV " << (uint16_t)dci.m_rv.at (j));
769  }
770  }
771  else
772  {
773  // empty TB of layer j
774  dci.m_ndi.at (j) = 0;
775  dci.m_rv.at (j) = 0;
776  dci.m_mcs.at (j) = 0;
777  dci.m_tbsSize.at (j) = 0;
778  NS_LOG_INFO (this << " layer " << (uint16_t)j << " no retx");
779  }
780  }
781  for (uint16_t k = 0; k < (*itRlcPdu).second.at (0).at (dci.m_harqProcess).size (); k++)
782  {
783  std::vector <struct RlcPduListElement_s> rlcPduListPerLc;
784  for (uint8_t j = 0; j < nLayers; j++)
785  {
786  if (retx.at (j))
787  {
788  if (j < dci.m_ndi.size ())
789  {
790  NS_LOG_INFO (" layer " << (uint16_t)j << " tb size " << dci.m_tbsSize.at (j));
791  rlcPduListPerLc.push_back ((*itRlcPdu).second.at (j).at (dci.m_harqProcess).at (k));
792  }
793  }
794  else
795  { // if no retx needed on layer j, push an RlcPduListElement_s object with m_size=0 to keep the size of rlcPduListPerLc vector = 2 in case of MIMO
796  NS_LOG_INFO (" layer " << (uint16_t)j << " tb size "<<dci.m_tbsSize.at (j));
797  RlcPduListElement_s emptyElement;
798  emptyElement.m_logicalChannelIdentity = (*itRlcPdu).second.at (j).at (dci.m_harqProcess).at (k).m_logicalChannelIdentity;
799  emptyElement.m_size = 0;
800  rlcPduListPerLc.push_back (emptyElement);
801  }
802  }
803 
804  if (rlcPduListPerLc.size () > 0)
805  {
806  newEl.m_rlcPduList.push_back (rlcPduListPerLc);
807  }
808  }
809  newEl.m_rnti = rnti;
810  newEl.m_dci = dci;
811  (*itHarq).second.at (harqId).m_rv = dci.m_rv;
812  // refresh timer
813  std::map <uint16_t, DlHarqProcessesTimer_t>::iterator itHarqTimer = m_dlHarqProcessesTimer.find (rnti);
814  if (itHarqTimer== m_dlHarqProcessesTimer.end ())
815  {
816  NS_FATAL_ERROR ("Unable to find HARQ timer for RNTI " << (uint16_t)rnti);
817  }
818  (*itHarqTimer).second.at (harqId) = 0;
819  ret.m_buildDataList.push_back (newEl);
820  rntiAllocated.insert (rnti);
821  }
822  else
823  {
824  // update HARQ process status
825  NS_LOG_INFO (this << " HARQ received ACK for UE " << m_dlInfoListBuffered.at (i).m_rnti);
826  std::map <uint16_t, DlHarqProcessesStatus_t>::iterator it = m_dlHarqProcessesStatus.find (m_dlInfoListBuffered.at (i).m_rnti);
827  if (it == m_dlHarqProcessesStatus.end ())
828  {
829  NS_FATAL_ERROR ("No info find in HARQ buffer for UE " << m_dlInfoListBuffered.at (i).m_rnti);
830  }
831  (*it).second.at (m_dlInfoListBuffered.at (i).m_harqProcessId) = 0;
832  std::map <uint16_t, DlHarqRlcPduListBuffer_t>::iterator itRlcPdu = m_dlHarqProcessesRlcPduListBuffer.find (m_dlInfoListBuffered.at (i).m_rnti);
833  if (itRlcPdu == m_dlHarqProcessesRlcPduListBuffer.end ())
834  {
835  NS_FATAL_ERROR ("Unable to find RlcPdcList in HARQ buffer for RNTI " << m_dlInfoListBuffered.at (i).m_rnti);
836  }
837  for (uint16_t k = 0; k < (*itRlcPdu).second.size (); k++)
838  {
839  (*itRlcPdu).second.at (k).at (m_dlInfoListBuffered.at (i).m_harqProcessId).clear ();
840  }
841  }
842  }
843  m_dlInfoListBuffered.clear ();
844  m_dlInfoListBuffered = dlInfoListUntxed;
845 
846  if (rbgAllocatedNum == rbgNum)
847  {
848  // all the RBGs are already allocated -> exit
849  if ((ret.m_buildDataList.size () > 0) || (ret.m_buildRarList.size () > 0))
850  {
852  }
853  return;
854  }
855 
856 
857 
858  for (int i = 0; i < rbgNum; i++)
859  {
860  NS_LOG_INFO (this << " ALLOCATION for RBG " << i << " of " << rbgNum);
861  if (rbgMap.at (i) == false)
862  {
863  std::set <uint16_t>::iterator it;
864  std::set <uint16_t>::iterator itMax = m_flowStatsDl.end ();
865  double rcqiMax = 0.0;
866  for (it = m_flowStatsDl.begin (); it != m_flowStatsDl.end (); it++)
867  {
868  std::set <uint16_t>::iterator itRnti = rntiAllocated.find ((*it));
869  if ((itRnti != rntiAllocated.end ())||(!HarqProcessAvailability ((*it))))
870  {
871  // UE already allocated for HARQ or without HARQ process available -> drop it
872  if (itRnti != rntiAllocated.end ())
873  {
874  NS_LOG_DEBUG (this << " RNTI discared for HARQ tx" << (uint16_t)(*it));
875  }
876  if (!HarqProcessAvailability ((*it)))
877  {
878  NS_LOG_DEBUG (this << " RNTI discared for HARQ id" << (uint16_t)(*it));
879  }
880  continue;
881  }
882 
883  std::map <uint16_t,SbMeasResult_s>::iterator itCqi;
884  itCqi = m_a30CqiRxed.find ((*it));
885  std::map <uint16_t,uint8_t>::iterator itTxMode;
886  itTxMode = m_uesTxMode.find ((*it));
887  if (itTxMode == m_uesTxMode.end ())
888  {
889  NS_FATAL_ERROR ("No Transmission Mode info on user " << (*it));
890  }
891  int nLayer = TransmissionModesLayers::TxMode2LayerNum ((*itTxMode).second);
892  std::vector <uint8_t> sbCqi;
893  if (itCqi == m_a30CqiRxed.end ())
894  {
895  for (uint8_t k = 0; k < nLayer; k++)
896  {
897  sbCqi.push_back (1); // start with lowest value
898  }
899  }
900  else
901  {
902  sbCqi = (*itCqi).second.m_higherLayerSelected.at (i).m_sbCqi;
903  }
904  uint8_t cqi1 = sbCqi.at (0);
905  uint8_t cqi2 = 0;
906  if (sbCqi.size () > 1)
907  {
908  cqi2 = sbCqi.at (1);
909  }
910  if ((cqi1 > 0)||(cqi2 > 0)) // CQI == 0 means "out of range" (see table 7.2.3-1 of 36.213)
911  {
912  if (LcActivePerFlow ((*it)) > 0)
913  {
914  // this UE has data to transmit
915  double achievableRate = 0.0;
916  uint8_t mcs = 0;
917  for (uint8_t k = 0; k < nLayer; k++)
918  {
919  if (sbCqi.size () > k)
920  {
921  mcs = m_amc->GetMcsFromCqi (sbCqi.at (k));
922  }
923  else
924  {
925  // no info on this subband -> worst MCS
926  mcs = 0;
927  }
928  achievableRate += ((m_amc->GetTbSizeFromMcs (mcs, rbgSize) / 8) / 0.001); // = TB size / TTI
929  }
930 
931  double rcqi = achievableRate;
932  NS_LOG_INFO (this << " RNTI " << (*it) << " MCS " << (uint32_t)mcs << " achievableRate " << achievableRate << " RCQI " << rcqi);
933 
934  if (rcqi > rcqiMax)
935  {
936  rcqiMax = rcqi;
937  itMax = it;
938  }
939  }
940  } // end if cqi
941 
942  } // end for m_rlcBufferReq
943 
944  if (itMax == m_flowStatsDl.end ())
945  {
946  // no UE available for this RB
947  NS_LOG_INFO (this << " any UE found");
948  }
949  else
950  {
951  rbgMap.at (i) = true;
952  std::map <uint16_t, std::vector <uint16_t> >::iterator itMap;
953  itMap = allocationMap.find ((*itMax));
954  if (itMap == allocationMap.end ())
955  {
956  // insert new element
957  std::vector <uint16_t> tempMap;
958  tempMap.push_back (i);
959  allocationMap.insert (std::pair <uint16_t, std::vector <uint16_t> > ((*itMax), tempMap));
960  }
961  else
962  {
963  (*itMap).second.push_back (i);
964  }
965  NS_LOG_INFO (this << " UE assigned " << (*itMax));
966  }
967  } // end for RBG free
968  } // end for RBGs
969 
970  // generate the transmission opportunities by grouping the RBGs of the same RNTI and
971  // creating the correspondent DCIs
972  std::map <uint16_t, std::vector <uint16_t> >::iterator itMap = allocationMap.begin ();
973  while (itMap != allocationMap.end ())
974  {
975  // create new BuildDataListElement_s for this LC
977  newEl.m_rnti = (*itMap).first;
978  // create the DlDciListElement_s
979  DlDciListElement_s newDci;
980  newDci.m_rnti = (*itMap).first;
981  newDci.m_harqProcess = UpdateHarqProcessId ((*itMap).first);
982 
983  uint16_t lcActives = LcActivePerFlow ((*itMap).first);
984  NS_LOG_INFO (this << "Allocate user " << newEl.m_rnti << " rbg " << lcActives);
985  if (lcActives == 0)
986  {
987  // Set to max value, to avoid divide by 0 below
988  lcActives = (uint16_t)65535; // UINT16_MAX;
989  }
990  uint16_t RgbPerRnti = (*itMap).second.size ();
991  std::map <uint16_t,SbMeasResult_s>::iterator itCqi;
992  itCqi = m_a30CqiRxed.find ((*itMap).first);
993  std::map <uint16_t,uint8_t>::iterator itTxMode;
994  itTxMode = m_uesTxMode.find ((*itMap).first);
995  if (itTxMode == m_uesTxMode.end ())
996  {
997  NS_FATAL_ERROR ("No Transmission Mode info on user " << (*itMap).first);
998  }
999  int nLayer = TransmissionModesLayers::TxMode2LayerNum ((*itTxMode).second);
1000  std::vector <uint8_t> worstCqi (2, 15);
1001  if (itCqi != m_a30CqiRxed.end ())
1002  {
1003  for (uint16_t k = 0; k < (*itMap).second.size (); k++)
1004  {
1005  if ((*itCqi).second.m_higherLayerSelected.size () > (*itMap).second.at (k))
1006  {
1007  NS_LOG_INFO (this << " RBG " << (*itMap).second.at (k) << " CQI " << (uint16_t)((*itCqi).second.m_higherLayerSelected.at ((*itMap).second.at (k)).m_sbCqi.at (0)) );
1008  for (uint8_t j = 0; j < nLayer; j++)
1009  {
1010  if ((*itCqi).second.m_higherLayerSelected.at ((*itMap).second.at (k)).m_sbCqi.size () > j)
1011  {
1012  if (((*itCqi).second.m_higherLayerSelected.at ((*itMap).second.at (k)).m_sbCqi.at (j)) < worstCqi.at (j))
1013  {
1014  worstCqi.at (j) = ((*itCqi).second.m_higherLayerSelected.at ((*itMap).second.at (k)).m_sbCqi.at (j));
1015  }
1016  }
1017  else
1018  {
1019  // no CQI for this layer of this suband -> worst one
1020  worstCqi.at (j) = 1;
1021  }
1022  }
1023  }
1024  else
1025  {
1026  for (uint8_t j = 0; j < nLayer; j++)
1027  {
1028  worstCqi.at (j) = 1; // try with lowest MCS in RBG with no info on channel
1029  }
1030  }
1031  }
1032  }
1033  else
1034  {
1035  for (uint8_t j = 0; j < nLayer; j++)
1036  {
1037  worstCqi.at (j) = 1; // try with lowest MCS in RBG with no info on channel
1038  }
1039  }
1040  for (uint8_t j = 0; j < nLayer; j++)
1041  {
1042  NS_LOG_INFO (this << " Layer " << (uint16_t)j << " CQI selected " << (uint16_t)worstCqi.at (j));
1043  }
1044  uint32_t bytesTxed = 0;
1045  for (uint8_t j = 0; j < nLayer; j++)
1046  {
1047  newDci.m_mcs.push_back (m_amc->GetMcsFromCqi (worstCqi.at (j)));
1048  int tbSize = (m_amc->GetTbSizeFromMcs (newDci.m_mcs.at (j), RgbPerRnti * rbgSize) / 8); // (size of TB in bytes according to table 7.1.7.2.1-1 of 36.213)
1049  newDci.m_tbsSize.push_back (tbSize);
1050  NS_LOG_INFO (this << " Layer " << (uint16_t)j << " MCS selected" << m_amc->GetMcsFromCqi (worstCqi.at (j)));
1051  bytesTxed += tbSize;
1052  }
1053 
1054  newDci.m_resAlloc = 0; // only allocation type 0 at this stage
1055  newDci.m_rbBitmap = 0; // TBD (32 bit bitmap see 7.1.6 of 36.213)
1056  uint32_t rbgMask = 0;
1057  for (uint16_t k = 0; k < (*itMap).second.size (); k++)
1058  {
1059  rbgMask = rbgMask + (0x1 << (*itMap).second.at (k));
1060  NS_LOG_INFO (this << " Allocated RBG " << (*itMap).second.at (k));
1061  }
1062  newDci.m_rbBitmap = rbgMask; // (32 bit bitmap see 7.1.6 of 36.213)
1063 
1064  // create the rlc PDUs -> equally divide resources among actives LCs
1065  std::map <LteFlowId_t, FfMacSchedSapProvider::SchedDlRlcBufferReqParameters>::iterator itBufReq;
1066  for (itBufReq = m_rlcBufferReq.begin (); itBufReq != m_rlcBufferReq.end (); itBufReq++)
1067  {
1068  if (((*itBufReq).first.m_rnti == (*itMap).first)
1069  && (((*itBufReq).second.m_rlcTransmissionQueueSize > 0)
1070  || ((*itBufReq).second.m_rlcRetransmissionQueueSize > 0)
1071  || ((*itBufReq).second.m_rlcStatusPduSize > 0) ))
1072  {
1073  std::vector <struct RlcPduListElement_s> newRlcPduLe;
1074  for (uint8_t j = 0; j < nLayer; j++)
1075  {
1076  RlcPduListElement_s newRlcEl;
1077  newRlcEl.m_logicalChannelIdentity = (*itBufReq).first.m_lcId;
1078  newRlcEl.m_size = newDci.m_tbsSize.at (j) / lcActives;
1079  NS_LOG_INFO (this << " LCID " << (uint32_t) newRlcEl.m_logicalChannelIdentity << " size " << newRlcEl.m_size << " layer " << (uint16_t)j);
1080  newRlcPduLe.push_back (newRlcEl);
1081  UpdateDlRlcBufferInfo (newDci.m_rnti, newRlcEl.m_logicalChannelIdentity, newRlcEl.m_size);
1082  if (m_harqOn == true)
1083  {
1084  // store RLC PDU list for HARQ
1085  std::map <uint16_t, DlHarqRlcPduListBuffer_t>::iterator itRlcPdu = m_dlHarqProcessesRlcPduListBuffer.find ((*itMap).first);
1086  if (itRlcPdu == m_dlHarqProcessesRlcPduListBuffer.end ())
1087  {
1088  NS_FATAL_ERROR ("Unable to find RlcPdcList in HARQ buffer for RNTI " << (*itMap).first);
1089  }
1090  (*itRlcPdu).second.at (j).at (newDci.m_harqProcess).push_back (newRlcEl);
1091  }
1092  }
1093  newEl.m_rlcPduList.push_back (newRlcPduLe);
1094  }
1095  if ((*itBufReq).first.m_rnti > (*itMap).first)
1096  {
1097  break;
1098  }
1099  }
1100  for (uint8_t j = 0; j < nLayer; j++)
1101  {
1102  newDci.m_ndi.push_back (1);
1103  newDci.m_rv.push_back (0);
1104  }
1105 
1106  newDci.m_tpc = 1; //1 is mapped to 0 in Accumulated Mode and to -1 in Absolute Mode
1107 
1108  newEl.m_dci = newDci;
1109 
1110  if (m_harqOn == true)
1111  {
1112  // store DCI for HARQ
1113  std::map <uint16_t, DlHarqProcessesDciBuffer_t>::iterator itDci = m_dlHarqProcessesDciBuffer.find (newEl.m_rnti);
1114  if (itDci == m_dlHarqProcessesDciBuffer.end ())
1115  {
1116  NS_FATAL_ERROR ("Unable to find RNTI entry in DCI HARQ buffer for RNTI " << newEl.m_rnti);
1117  }
1118  (*itDci).second.at (newDci.m_harqProcess) = newDci;
1119  // refresh timer
1120  std::map <uint16_t, DlHarqProcessesTimer_t>::iterator itHarqTimer = m_dlHarqProcessesTimer.find (newEl.m_rnti);
1121  if (itHarqTimer== m_dlHarqProcessesTimer.end ())
1122  {
1123  NS_FATAL_ERROR ("Unable to find HARQ timer for RNTI " << (uint16_t)newEl.m_rnti);
1124  }
1125  (*itHarqTimer).second.at (newDci.m_harqProcess) = 0;
1126  }
1127 
1128  // ...more parameters -> ingored in this version
1129 
1130  ret.m_buildDataList.push_back (newEl);
1131 
1132  itMap++;
1133  } // end while allocation
1134  ret.m_nrOfPdcchOfdmSymbols = 1;
1135 
1137 
1138 
1139  return;
1140 }
1141 
1142 void
1144 {
1145  NS_LOG_FUNCTION (this);
1146 
1147  m_rachList = params.m_rachList;
1148 
1149  return;
1150 }
1151 
1152 void
1154 {
1155  NS_LOG_FUNCTION (this);
1156 
1157  for (unsigned int i = 0; i < params.m_cqiList.size (); i++)
1158  {
1159  if ( params.m_cqiList.at (i).m_cqiType == CqiListElement_s::P10 )
1160  {
1161  NS_LOG_LOGIC ("wideband CQI " << (uint32_t) params.m_cqiList.at (i).m_wbCqi.at (0) << " reported");
1162  std::map <uint16_t,uint8_t>::iterator it;
1163  uint16_t rnti = params.m_cqiList.at (i).m_rnti;
1164  it = m_p10CqiRxed.find (rnti);
1165  if (it == m_p10CqiRxed.end ())
1166  {
1167  // create the new entry
1168  m_p10CqiRxed.insert ( std::pair<uint16_t, uint8_t > (rnti, params.m_cqiList.at (i).m_wbCqi.at (0)) ); // only codeword 0 at this stage (SISO)
1169  // generate correspondent timer
1170  m_p10CqiTimers.insert ( std::pair<uint16_t, uint32_t > (rnti, m_cqiTimersThreshold));
1171  }
1172  else
1173  {
1174  // update the CQI value and refresh correspondent timer
1175  (*it).second = params.m_cqiList.at (i).m_wbCqi.at (0);
1176  // update correspondent timer
1177  std::map <uint16_t,uint32_t>::iterator itTimers;
1178  itTimers = m_p10CqiTimers.find (rnti);
1179  (*itTimers).second = m_cqiTimersThreshold;
1180  }
1181  }
1182  else if ( params.m_cqiList.at (i).m_cqiType == CqiListElement_s::A30 )
1183  {
1184  // subband CQI reporting high layer configured
1185  std::map <uint16_t,SbMeasResult_s>::iterator it;
1186  uint16_t rnti = params.m_cqiList.at (i).m_rnti;
1187  it = m_a30CqiRxed.find (rnti);
1188  if (it == m_a30CqiRxed.end ())
1189  {
1190  // create the new entry
1191  m_a30CqiRxed.insert ( std::pair<uint16_t, SbMeasResult_s > (rnti, params.m_cqiList.at (i).m_sbMeasResult) );
1192  m_a30CqiTimers.insert ( std::pair<uint16_t, uint32_t > (rnti, m_cqiTimersThreshold));
1193  }
1194  else
1195  {
1196  // update the CQI value and refresh correspondent timer
1197  (*it).second = params.m_cqiList.at (i).m_sbMeasResult;
1198  std::map <uint16_t,uint32_t>::iterator itTimers;
1199  itTimers = m_a30CqiTimers.find (rnti);
1200  (*itTimers).second = m_cqiTimersThreshold;
1201  }
1202  }
1203  else
1204  {
1205  NS_LOG_ERROR (this << " CQI type unknown");
1206  }
1207  }
1208 
1209  return;
1210 }
1211 
1212 
1213 double
1214 FdMtFfMacScheduler::EstimateUlSinr (uint16_t rnti, uint16_t rb)
1215 {
1216  std::map <uint16_t, std::vector <double> >::iterator itCqi = m_ueCqi.find (rnti);
1217  if (itCqi == m_ueCqi.end ())
1218  {
1219  // no cqi info about this UE
1220  return (NO_SINR);
1221 
1222  }
1223  else
1224  {
1225  // take the average SINR value among the available
1226  double sinrSum = 0;
1227  unsigned int sinrNum = 0;
1228  for (uint32_t i = 0; i < m_cschedCellConfig.m_ulBandwidth; i++)
1229  {
1230  double sinr = (*itCqi).second.at (i);
1231  if (sinr != NO_SINR)
1232  {
1233  sinrSum += sinr;
1234  sinrNum++;
1235  }
1236  }
1237  double estimatedSinr = (sinrNum > 0) ? (sinrSum / sinrNum) : DBL_MAX;
1238  // store the value
1239  (*itCqi).second.at (rb) = estimatedSinr;
1240  return (estimatedSinr);
1241  }
1242 }
1243 
1244 void
1246 {
1247  NS_LOG_FUNCTION (this << " UL - Frame no. " << (params.m_sfnSf >> 4) << " subframe no. " << (0xF & params.m_sfnSf) << " size " << params.m_ulInfoList.size ());
1248 
1249  RefreshUlCqiMaps ();
1250 
1251  // Generate RBs map
1253  std::vector <bool> rbMap;
1254  uint16_t rbAllocatedNum = 0;
1255  std::set <uint16_t> rntiAllocated;
1256  std::vector <uint16_t> rbgAllocationMap;
1257  // update with RACH allocation map
1258  rbgAllocationMap = m_rachAllocationMap;
1259  //rbgAllocationMap.resize (m_cschedCellConfig.m_ulBandwidth, 0);
1260  m_rachAllocationMap.clear ();
1262 
1263  rbMap.resize (m_cschedCellConfig.m_ulBandwidth, false);
1264  // remove RACH allocation
1265  for (uint16_t i = 0; i < m_cschedCellConfig.m_ulBandwidth; i++)
1266  {
1267  if (rbgAllocationMap.at (i) != 0)
1268  {
1269  rbMap.at (i) = true;
1270  NS_LOG_DEBUG (this << " Allocated for RACH " << i);
1271  }
1272  }
1273 
1274 
1275  if (m_harqOn == true)
1276  {
1277  // Process UL HARQ feedback
1278  for (uint16_t i = 0; i < params.m_ulInfoList.size (); i++)
1279  {
1280  if (params.m_ulInfoList.at (i).m_receptionStatus == UlInfoListElement_s::NotOk)
1281  {
1282  // retx correspondent block: retrieve the UL-DCI
1283  uint16_t rnti = params.m_ulInfoList.at (i).m_rnti;
1284  std::map <uint16_t, uint8_t>::iterator itProcId = m_ulHarqCurrentProcessId.find (rnti);
1285  if (itProcId == m_ulHarqCurrentProcessId.end ())
1286  {
1287  NS_LOG_ERROR ("No info find in HARQ buffer for UE (might change eNB) " << rnti);
1288  }
1289  uint8_t harqId = (uint8_t)((*itProcId).second - HARQ_PERIOD) % HARQ_PROC_NUM;
1290  NS_LOG_INFO (this << " UL-HARQ retx RNTI " << rnti << " harqId " << (uint16_t)harqId << " i " << i << " size " << params.m_ulInfoList.size ());
1291  std::map <uint16_t, UlHarqProcessesDciBuffer_t>::iterator itHarq = m_ulHarqProcessesDciBuffer.find (rnti);
1292  if (itHarq == m_ulHarqProcessesDciBuffer.end ())
1293  {
1294  NS_LOG_ERROR ("No info find in HARQ buffer for UE (might change eNB) " << rnti);
1295  continue;
1296  }
1297  UlDciListElement_s dci = (*itHarq).second.at (harqId);
1298  std::map <uint16_t, UlHarqProcessesStatus_t>::iterator itStat = m_ulHarqProcessesStatus.find (rnti);
1299  if (itStat == m_ulHarqProcessesStatus.end ())
1300  {
1301  NS_LOG_ERROR ("No info find in HARQ buffer for UE (might change eNB) " << rnti);
1302  }
1303  if ((*itStat).second.at (harqId) >= 3)
1304  {
1305  NS_LOG_INFO ("Max number of retransmissions reached (UL)-> drop process");
1306  continue;
1307  }
1308  bool free = true;
1309  for (int j = dci.m_rbStart; j < dci.m_rbStart + dci.m_rbLen; j++)
1310  {
1311  if (rbMap.at (j) == true)
1312  {
1313  free = false;
1314  NS_LOG_INFO (this << " BUSY " << j);
1315  }
1316  }
1317  if (free)
1318  {
1319  // retx on the same RBs
1320  for (int j = dci.m_rbStart; j < dci.m_rbStart + dci.m_rbLen; j++)
1321  {
1322  rbMap.at (j) = true;
1323  rbgAllocationMap.at (j) = dci.m_rnti;
1324  NS_LOG_INFO ("\tRB " << j);
1325  rbAllocatedNum++;
1326  }
1327  NS_LOG_INFO (this << " Send retx in the same RBs " << (uint16_t)dci.m_rbStart << " to " << dci.m_rbStart + dci.m_rbLen << " RV " << (*itStat).second.at (harqId) + 1);
1328  }
1329  else
1330  {
1331  NS_LOG_INFO ("Cannot allocate retx due to RACH allocations for UE " << rnti);
1332  continue;
1333  }
1334  dci.m_ndi = 0;
1335  // Update HARQ buffers with new HarqId
1336  (*itStat).second.at ((*itProcId).second) = (*itStat).second.at (harqId) + 1;
1337  (*itStat).second.at (harqId) = 0;
1338  (*itHarq).second.at ((*itProcId).second) = dci;
1339  ret.m_dciList.push_back (dci);
1340  rntiAllocated.insert (dci.m_rnti);
1341  }
1342  else
1343  {
1344  NS_LOG_INFO (this << " HARQ-ACK feedback from RNTI " << params.m_ulInfoList.at (i).m_rnti);
1345  }
1346  }
1347  }
1348 
1349  std::map <uint16_t,uint32_t>::iterator it;
1350  int nflows = 0;
1351 
1352  for (it = m_ceBsrRxed.begin (); it != m_ceBsrRxed.end (); it++)
1353  {
1354  std::set <uint16_t>::iterator itRnti = rntiAllocated.find ((*it).first);
1355  // select UEs with queues not empty and not yet allocated for HARQ
1356  if (((*it).second > 0)&&(itRnti == rntiAllocated.end ()))
1357  {
1358  nflows++;
1359  }
1360  }
1361 
1362  if (nflows == 0)
1363  {
1364  if (ret.m_dciList.size () > 0)
1365  {
1366  m_allocationMaps.insert (std::pair <uint16_t, std::vector <uint16_t> > (params.m_sfnSf, rbgAllocationMap));
1368  }
1369 
1370  return; // no flows to be scheduled
1371  }
1372 
1373 
1374  // Divide the remaining resources equally among the active users starting from the subsequent one served last scheduling trigger
1375  uint16_t rbPerFlow = (m_cschedCellConfig.m_ulBandwidth) / (nflows + rntiAllocated.size ());
1376  if (rbPerFlow < 3)
1377  {
1378  rbPerFlow = 3; // at least 3 rbg per flow (till available resource) to ensure TxOpportunity >= 7 bytes
1379  }
1380  int rbAllocated = 0;
1381 
1382  if (m_nextRntiUl != 0)
1383  {
1384  for (it = m_ceBsrRxed.begin (); it != m_ceBsrRxed.end (); it++)
1385  {
1386  if ((*it).first == m_nextRntiUl)
1387  {
1388  break;
1389  }
1390  }
1391  if (it == m_ceBsrRxed.end ())
1392  {
1393  NS_LOG_ERROR (this << " no user found");
1394  }
1395  }
1396  else
1397  {
1398  it = m_ceBsrRxed.begin ();
1399  m_nextRntiUl = (*it).first;
1400  }
1401  do
1402  {
1403  std::set <uint16_t>::iterator itRnti = rntiAllocated.find ((*it).first);
1404  if ((itRnti != rntiAllocated.end ())||((*it).second == 0))
1405  {
1406  // UE already allocated for UL-HARQ -> skip it
1407  NS_LOG_DEBUG (this << " UE already allocated in HARQ -> discared, RNTI " << (*it).first);
1408  it++;
1409  if (it == m_ceBsrRxed.end ())
1410  {
1411  // restart from the first
1412  it = m_ceBsrRxed.begin ();
1413  }
1414  continue;
1415  }
1416  if (rbAllocated + rbPerFlow - 1 > m_cschedCellConfig.m_ulBandwidth)
1417  {
1418  // limit to physical resources last resource assignment
1419  rbPerFlow = m_cschedCellConfig.m_ulBandwidth - rbAllocated;
1420  // at least 3 rbg per flow to ensure TxOpportunity >= 7 bytes
1421  if (rbPerFlow < 3)
1422  {
1423  // terminate allocation
1424  rbPerFlow = 0;
1425  }
1426  }
1427 
1428  UlDciListElement_s uldci;
1429  uldci.m_rnti = (*it).first;
1430  uldci.m_rbLen = rbPerFlow;
1431  bool allocated = false;
1432  NS_LOG_INFO (this << " RB Allocated " << rbAllocated << " rbPerFlow " << rbPerFlow << " flows " << nflows);
1433  while ((!allocated)&&((rbAllocated + rbPerFlow - m_cschedCellConfig.m_ulBandwidth) < 1) && (rbPerFlow != 0))
1434  {
1435  // check availability
1436  bool free = true;
1437  for (uint16_t j = rbAllocated; j < rbAllocated + rbPerFlow; j++)
1438  {
1439  if (rbMap.at (j) == true)
1440  {
1441  free = false;
1442  break;
1443  }
1444  }
1445  if (free)
1446  {
1447  uldci.m_rbStart = rbAllocated;
1448 
1449  for (uint16_t j = rbAllocated; j < rbAllocated + rbPerFlow; j++)
1450  {
1451  rbMap.at (j) = true;
1452  // store info on allocation for managing ul-cqi interpretation
1453  rbgAllocationMap.at (j) = (*it).first;
1454  }
1455  rbAllocated += rbPerFlow;
1456  allocated = true;
1457  break;
1458  }
1459  rbAllocated++;
1460  if (rbAllocated + rbPerFlow - 1 > m_cschedCellConfig.m_ulBandwidth)
1461  {
1462  // limit to physical resources last resource assignment
1463  rbPerFlow = m_cschedCellConfig.m_ulBandwidth - rbAllocated;
1464  // at least 3 rbg per flow to ensure TxOpportunity >= 7 bytes
1465  if (rbPerFlow < 3)
1466  {
1467  // terminate allocation
1468  rbPerFlow = 0;
1469  }
1470  }
1471  }
1472  if (!allocated)
1473  {
1474  // unable to allocate new resource: finish scheduling
1475  m_nextRntiUl = (*it).first;
1476  if (ret.m_dciList.size () > 0)
1477  {
1479  }
1480  m_allocationMaps.insert (std::pair <uint16_t, std::vector <uint16_t> > (params.m_sfnSf, rbgAllocationMap));
1481  return;
1482  }
1483 
1484 
1485 
1486  std::map <uint16_t, std::vector <double> >::iterator itCqi = m_ueCqi.find ((*it).first);
1487  int cqi = 0;
1488  if (itCqi == m_ueCqi.end ())
1489  {
1490  // no cqi info about this UE
1491  uldci.m_mcs = 0; // MCS 0 -> UL-AMC TBD
1492  }
1493  else
1494  {
1495  // take the lowest CQI value (worst RB)
1496  double minSinr = (*itCqi).second.at (uldci.m_rbStart);
1497  if (minSinr == NO_SINR)
1498  {
1499  minSinr = EstimateUlSinr ((*it).first, uldci.m_rbStart);
1500  }
1501  for (uint16_t i = uldci.m_rbStart; i < uldci.m_rbStart + uldci.m_rbLen; i++)
1502  {
1503  double sinr = (*itCqi).second.at (i);
1504  if (sinr == NO_SINR)
1505  {
1506  sinr = EstimateUlSinr ((*it).first, i);
1507  }
1508  if (sinr < minSinr)
1509  {
1510  minSinr = sinr;
1511  }
1512  }
1513 
1514  // translate SINR -> cqi: WILD ACK: same as DL
1515  double s = log2 ( 1 + (
1516  std::pow (10, minSinr / 10 ) /
1517  ( (-std::log (5.0 * 0.00005 )) / 1.5) ));
1518  cqi = m_amc->GetCqiFromSpectralEfficiency (s);
1519  if (cqi == 0)
1520  {
1521  it++;
1522  if (it == m_ceBsrRxed.end ())
1523  {
1524  // restart from the first
1525  it = m_ceBsrRxed.begin ();
1526  }
1527  NS_LOG_DEBUG (this << " UE discared for CQI=0, RNTI " << uldci.m_rnti);
1528  // remove UE from allocation map
1529  for (uint16_t i = uldci.m_rbStart; i < uldci.m_rbStart + uldci.m_rbLen; i++)
1530  {
1531  rbgAllocationMap.at (i) = 0;
1532  }
1533  continue; // CQI == 0 means "out of range" (see table 7.2.3-1 of 36.213)
1534  }
1535  uldci.m_mcs = m_amc->GetMcsFromCqi (cqi);
1536  }
1537 
1538  uldci.m_tbSize = (m_amc->GetTbSizeFromMcs (uldci.m_mcs, rbPerFlow) / 8);
1539  UpdateUlRlcBufferInfo (uldci.m_rnti, uldci.m_tbSize);
1540  uldci.m_ndi = 1;
1541  uldci.m_cceIndex = 0;
1542  uldci.m_aggrLevel = 1;
1543  uldci.m_ueTxAntennaSelection = 3; // antenna selection OFF
1544  uldci.m_hopping = false;
1545  uldci.m_n2Dmrs = 0;
1546  uldci.m_tpc = 0; // no power control
1547  uldci.m_cqiRequest = false; // only period CQI at this stage
1548  uldci.m_ulIndex = 0; // TDD parameter
1549  uldci.m_dai = 1; // TDD parameter
1550  uldci.m_freqHopping = 0;
1551  uldci.m_pdcchPowerOffset = 0; // not used
1552  ret.m_dciList.push_back (uldci);
1553  // store DCI for HARQ_PERIOD
1554  uint8_t harqId = 0;
1555  if (m_harqOn == true)
1556  {
1557  std::map <uint16_t, uint8_t>::iterator itProcId;
1558  itProcId = m_ulHarqCurrentProcessId.find (uldci.m_rnti);
1559  if (itProcId == m_ulHarqCurrentProcessId.end ())
1560  {
1561  NS_FATAL_ERROR ("No info find in HARQ buffer for UE " << uldci.m_rnti);
1562  }
1563  harqId = (*itProcId).second;
1564  std::map <uint16_t, UlHarqProcessesDciBuffer_t>::iterator itDci = m_ulHarqProcessesDciBuffer.find (uldci.m_rnti);
1565  if (itDci == m_ulHarqProcessesDciBuffer.end ())
1566  {
1567  NS_FATAL_ERROR ("Unable to find RNTI entry in UL DCI HARQ buffer for RNTI " << uldci.m_rnti);
1568  }
1569  (*itDci).second.at (harqId) = uldci;
1570  // Update HARQ process status (RV 0)
1571  std::map <uint16_t, UlHarqProcessesStatus_t>::iterator itStat = m_ulHarqProcessesStatus.find (uldci.m_rnti);
1572  if (itStat == m_ulHarqProcessesStatus.end ())
1573  {
1574  NS_LOG_ERROR ("No info find in HARQ buffer for UE (might change eNB) " << uldci.m_rnti);
1575  }
1576  (*itStat).second.at (harqId) = 0;
1577  }
1578 
1579  NS_LOG_INFO (this << " UE Allocation RNTI " << (*it).first << " startPRB " << (uint32_t)uldci.m_rbStart << " nPRB " << (uint32_t)uldci.m_rbLen << " CQI " << cqi << " MCS " << (uint32_t)uldci.m_mcs << " TBsize " << uldci.m_tbSize << " RbAlloc " << rbAllocated << " harqId " << (uint16_t)harqId);
1580 
1581 
1582  it++;
1583  if (it == m_ceBsrRxed.end ())
1584  {
1585  // restart from the first
1586  it = m_ceBsrRxed.begin ();
1587  }
1588  if ((rbAllocated == m_cschedCellConfig.m_ulBandwidth) || (rbPerFlow == 0))
1589  {
1590  // Stop allocation: no more PRBs
1591  m_nextRntiUl = (*it).first;
1592  break;
1593  }
1594  }
1595  while (((*it).first != m_nextRntiUl)&&(rbPerFlow!=0));
1596 
1597 
1598  m_allocationMaps.insert (std::pair <uint16_t, std::vector <uint16_t> > (params.m_sfnSf, rbgAllocationMap));
1600 
1601  return;
1602 }
1603 
1604 void
1606 {
1607  NS_LOG_FUNCTION (this);
1608  return;
1609 }
1610 
1611 void
1613 {
1614  NS_LOG_FUNCTION (this);
1615  return;
1616 }
1617 
1618 void
1620 {
1621  NS_LOG_FUNCTION (this);
1622 
1623  std::map <uint16_t,uint32_t>::iterator it;
1624 
1625  for (unsigned int i = 0; i < params.m_macCeList.size (); i++)
1626  {
1627  if ( params.m_macCeList.at (i).m_macCeType == MacCeListElement_s::BSR )
1628  {
1629  // buffer status report
1630  // note that this scheduler does not differentiate the
1631  // allocation according to which LCGs have more/less bytes
1632  // to send.
1633  // Hence the BSR of different LCGs are just summed up to get
1634  // a total queue size that is used for allocation purposes.
1635 
1636  uint32_t buffer = 0;
1637  for (uint8_t lcg = 0; lcg < 4; ++lcg)
1638  {
1639  uint8_t bsrId = params.m_macCeList.at (i).m_macCeValue.m_bufferStatus.at (lcg);
1640  buffer += BufferSizeLevelBsr::BsrId2BufferSize (bsrId);
1641  }
1642 
1643  uint16_t rnti = params.m_macCeList.at (i).m_rnti;
1644  NS_LOG_LOGIC (this << "RNTI=" << rnti << " buffer=" << buffer);
1645  it = m_ceBsrRxed.find (rnti);
1646  if (it == m_ceBsrRxed.end ())
1647  {
1648  // create the new entry
1649  m_ceBsrRxed.insert ( std::pair<uint16_t, uint32_t > (rnti, buffer));
1650  }
1651  else
1652  {
1653  // update the buffer size value
1654  (*it).second = buffer;
1655  }
1656  }
1657  }
1658 
1659  return;
1660 }
1661 
1662 void
1664 {
1665  NS_LOG_FUNCTION (this);
1666 // retrieve the allocation for this subframe
1667  switch (m_ulCqiFilter)
1668  {
1670  {
1671  // filter all the CQIs that are not SRS based
1672  if (params.m_ulCqi.m_type != UlCqi_s::SRS)
1673  {
1674  return;
1675  }
1676  }
1677  break;
1679  {
1680  // filter all the CQIs that are not SRS based
1681  if (params.m_ulCqi.m_type != UlCqi_s::PUSCH)
1682  {
1683  return;
1684  }
1685  }
1687  break;
1688 
1689  default:
1690  NS_FATAL_ERROR ("Unknown UL CQI type");
1691  }
1692 
1693  switch (params.m_ulCqi.m_type)
1694  {
1695  case UlCqi_s::PUSCH:
1696  {
1697  std::map <uint16_t, std::vector <uint16_t> >::iterator itMap;
1698  std::map <uint16_t, std::vector <double> >::iterator itCqi;
1699  NS_LOG_DEBUG (this << " Collect PUSCH CQIs of Frame no. " << (params.m_sfnSf >> 4) << " subframe no. " << (0xF & params.m_sfnSf));
1700  itMap = m_allocationMaps.find (params.m_sfnSf);
1701  if (itMap == m_allocationMaps.end ())
1702  {
1703  return;
1704  }
1705  for (uint32_t i = 0; i < (*itMap).second.size (); i++)
1706  {
1707  // convert from fixed point notation Sxxxxxxxxxxx.xxx to double
1708  double sinr = LteFfConverter::fpS11dot3toDouble (params.m_ulCqi.m_sinr.at (i));
1709  itCqi = m_ueCqi.find ((*itMap).second.at (i));
1710  if (itCqi == m_ueCqi.end ())
1711  {
1712  // create a new entry
1713  std::vector <double> newCqi;
1714  for (uint32_t j = 0; j < m_cschedCellConfig.m_ulBandwidth; j++)
1715  {
1716  if (i == j)
1717  {
1718  newCqi.push_back (sinr);
1719  }
1720  else
1721  {
1722  // initialize with NO_SINR value.
1723  newCqi.push_back (NO_SINR);
1724  }
1725 
1726  }
1727  m_ueCqi.insert (std::pair <uint16_t, std::vector <double> > ((*itMap).second.at (i), newCqi));
1728  // generate correspondent timer
1729  m_ueCqiTimers.insert (std::pair <uint16_t, uint32_t > ((*itMap).second.at (i), m_cqiTimersThreshold));
1730  }
1731  else
1732  {
1733  // update the value
1734  (*itCqi).second.at (i) = sinr;
1735  NS_LOG_DEBUG (this << " RNTI " << (*itMap).second.at (i) << " RB " << i << " SINR " << sinr);
1736  // update correspondent timer
1737  std::map <uint16_t, uint32_t>::iterator itTimers;
1738  itTimers = m_ueCqiTimers.find ((*itMap).second.at (i));
1739  (*itTimers).second = m_cqiTimersThreshold;
1740 
1741  }
1742 
1743  }
1744  // remove obsolete info on allocation
1745  m_allocationMaps.erase (itMap);
1746  }
1747  break;
1748  case UlCqi_s::SRS:
1749  {
1750  // get the RNTI from vendor specific parameters
1751  uint16_t rnti = 0;
1752  NS_ASSERT (params.m_vendorSpecificList.size () > 0);
1753  for (uint16_t i = 0; i < params.m_vendorSpecificList.size (); i++)
1754  {
1755  if (params.m_vendorSpecificList.at (i).m_type == SRS_CQI_RNTI_VSP)
1756  {
1757  Ptr<SrsCqiRntiVsp> vsp = DynamicCast<SrsCqiRntiVsp> (params.m_vendorSpecificList.at (i).m_value);
1758  rnti = vsp->GetRnti ();
1759  }
1760  }
1761  std::map <uint16_t, std::vector <double> >::iterator itCqi;
1762  itCqi = m_ueCqi.find (rnti);
1763  if (itCqi == m_ueCqi.end ())
1764  {
1765  // create a new entry
1766  std::vector <double> newCqi;
1767  for (uint32_t j = 0; j < m_cschedCellConfig.m_ulBandwidth; j++)
1768  {
1769  double sinr = LteFfConverter::fpS11dot3toDouble (params.m_ulCqi.m_sinr.at (j));
1770  newCqi.push_back (sinr);
1771  NS_LOG_INFO (this << " RNTI " << rnti << " new SRS-CQI for RB " << j << " value " << sinr);
1772 
1773  }
1774  m_ueCqi.insert (std::pair <uint16_t, std::vector <double> > (rnti, newCqi));
1775  // generate correspondent timer
1776  m_ueCqiTimers.insert (std::pair <uint16_t, uint32_t > (rnti, m_cqiTimersThreshold));
1777  }
1778  else
1779  {
1780  // update the values
1781  for (uint32_t j = 0; j < m_cschedCellConfig.m_ulBandwidth; j++)
1782  {
1783  double sinr = LteFfConverter::fpS11dot3toDouble (params.m_ulCqi.m_sinr.at (j));
1784  (*itCqi).second.at (j) = sinr;
1785  NS_LOG_INFO (this << " RNTI " << rnti << " update SRS-CQI for RB " << j << " value " << sinr);
1786  }
1787  // update correspondent timer
1788  std::map <uint16_t, uint32_t>::iterator itTimers;
1789  itTimers = m_ueCqiTimers.find (rnti);
1790  (*itTimers).second = m_cqiTimersThreshold;
1791 
1792  }
1793 
1794 
1795  }
1796  break;
1797  case UlCqi_s::PUCCH_1:
1798  case UlCqi_s::PUCCH_2:
1799  case UlCqi_s::PRACH:
1800  {
1801  NS_FATAL_ERROR ("FdMtFfMacScheduler supports only PUSCH and SRS UL-CQIs");
1802  }
1803  break;
1804  default:
1805  NS_FATAL_ERROR ("Unknown type of UL-CQI");
1806  }
1807  return;
1808 }
1809 
1810 void
1812 {
1813  // refresh DL CQI P01 Map
1814  std::map <uint16_t,uint32_t>::iterator itP10 = m_p10CqiTimers.begin ();
1815  while (itP10 != m_p10CqiTimers.end ())
1816  {
1817  NS_LOG_INFO (this << " P10-CQI for user " << (*itP10).first << " is " << (uint32_t)(*itP10).second << " thr " << (uint32_t)m_cqiTimersThreshold);
1818  if ((*itP10).second == 0)
1819  {
1820  // delete correspondent entries
1821  std::map <uint16_t,uint8_t>::iterator itMap = m_p10CqiRxed.find ((*itP10).first);
1822  NS_ASSERT_MSG (itMap != m_p10CqiRxed.end (), " Does not find CQI report for user " << (*itP10).first);
1823  NS_LOG_INFO (this << " P10-CQI expired for user " << (*itP10).first);
1824  m_p10CqiRxed.erase (itMap);
1825  std::map <uint16_t,uint32_t>::iterator temp = itP10;
1826  itP10++;
1827  m_p10CqiTimers.erase (temp);
1828  }
1829  else
1830  {
1831  (*itP10).second--;
1832  itP10++;
1833  }
1834  }
1835 
1836  // refresh DL CQI A30 Map
1837  std::map <uint16_t,uint32_t>::iterator itA30 = m_a30CqiTimers.begin ();
1838  while (itA30 != m_a30CqiTimers.end ())
1839  {
1840  NS_LOG_INFO (this << " A30-CQI for user " << (*itA30).first << " is " << (uint32_t)(*itA30).second << " thr " << (uint32_t)m_cqiTimersThreshold);
1841  if ((*itA30).second == 0)
1842  {
1843  // delete correspondent entries
1844  std::map <uint16_t,SbMeasResult_s>::iterator itMap = m_a30CqiRxed.find ((*itA30).first);
1845  NS_ASSERT_MSG (itMap != m_a30CqiRxed.end (), " Does not find CQI report for user " << (*itA30).first);
1846  NS_LOG_INFO (this << " A30-CQI expired for user " << (*itA30).first);
1847  m_a30CqiRxed.erase (itMap);
1848  std::map <uint16_t,uint32_t>::iterator temp = itA30;
1849  itA30++;
1850  m_a30CqiTimers.erase (temp);
1851  }
1852  else
1853  {
1854  (*itA30).second--;
1855  itA30++;
1856  }
1857  }
1858 
1859  return;
1860 }
1861 
1862 
1863 void
1865 {
1866  // refresh UL CQI Map
1867  std::map <uint16_t,uint32_t>::iterator itUl = m_ueCqiTimers.begin ();
1868  while (itUl != m_ueCqiTimers.end ())
1869  {
1870  NS_LOG_INFO (this << " UL-CQI for user " << (*itUl).first << " is " << (uint32_t)(*itUl).second << " thr " << (uint32_t)m_cqiTimersThreshold);
1871  if ((*itUl).second == 0)
1872  {
1873  // delete correspondent entries
1874  std::map <uint16_t, std::vector <double> >::iterator itMap = m_ueCqi.find ((*itUl).first);
1875  NS_ASSERT_MSG (itMap != m_ueCqi.end (), " Does not find CQI report for user " << (*itUl).first);
1876  NS_LOG_INFO (this << " UL-CQI exired for user " << (*itUl).first);
1877  (*itMap).second.clear ();
1878  m_ueCqi.erase (itMap);
1879  std::map <uint16_t,uint32_t>::iterator temp = itUl;
1880  itUl++;
1881  m_ueCqiTimers.erase (temp);
1882  }
1883  else
1884  {
1885  (*itUl).second--;
1886  itUl++;
1887  }
1888  }
1889 
1890  return;
1891 }
1892 
1893 void
1894 FdMtFfMacScheduler::UpdateDlRlcBufferInfo (uint16_t rnti, uint8_t lcid, uint16_t size)
1895 {
1896  std::map<LteFlowId_t, FfMacSchedSapProvider::SchedDlRlcBufferReqParameters>::iterator it;
1897  LteFlowId_t flow (rnti, lcid);
1898  it = m_rlcBufferReq.find (flow);
1899  if (it != m_rlcBufferReq.end ())
1900  {
1901  NS_LOG_INFO (this << " UE " << rnti << " LC " << (uint16_t)lcid << " txqueue " << (*it).second.m_rlcTransmissionQueueSize << " retxqueue " << (*it).second.m_rlcRetransmissionQueueSize << " status " << (*it).second.m_rlcStatusPduSize << " decrease " << size);
1902  // Update queues: RLC tx order Status, ReTx, Tx
1903  // Update status queue
1904  if (((*it).second.m_rlcStatusPduSize > 0) && (size >= (*it).second.m_rlcStatusPduSize))
1905  {
1906  (*it).second.m_rlcStatusPduSize = 0;
1907  }
1908  else if (((*it).second.m_rlcRetransmissionQueueSize > 0) && (size >= (*it).second.m_rlcRetransmissionQueueSize))
1909  {
1910  (*it).second.m_rlcRetransmissionQueueSize = 0;
1911  }
1912  else if ((*it).second.m_rlcTransmissionQueueSize > 0)
1913  {
1914  uint32_t rlcOverhead;
1915  if (lcid == 1)
1916  {
1917  // for SRB1 (using RLC AM) it's better to
1918  // overestimate RLC overhead rather than
1919  // underestimate it and risk unneeded
1920  // segmentation which increases delay
1921  rlcOverhead = 4;
1922  }
1923  else
1924  {
1925  // minimum RLC overhead due to header
1926  rlcOverhead = 2;
1927  }
1928  // update transmission queue
1929  if ((*it).second.m_rlcTransmissionQueueSize <= size - rlcOverhead)
1930  {
1931  (*it).second.m_rlcTransmissionQueueSize = 0;
1932  }
1933  else
1934  {
1935  (*it).second.m_rlcTransmissionQueueSize -= size - rlcOverhead;
1936  }
1937  }
1938  }
1939  else
1940  {
1941  NS_LOG_ERROR (this << " Does not find DL RLC Buffer Report of UE " << rnti);
1942  }
1943 }
1944 
1945 void
1946 FdMtFfMacScheduler::UpdateUlRlcBufferInfo (uint16_t rnti, uint16_t size)
1947 {
1948 
1949  size = size - 2; // remove the minimum RLC overhead
1950  std::map <uint16_t,uint32_t>::iterator it = m_ceBsrRxed.find (rnti);
1951  if (it != m_ceBsrRxed.end ())
1952  {
1953  NS_LOG_INFO (this << " UE " << rnti << " size " << size << " BSR " << (*it).second);
1954  if ((*it).second >= size)
1955  {
1956  (*it).second -= size;
1957  }
1958  else
1959  {
1960  (*it).second = 0;
1961  }
1962  }
1963  else
1964  {
1965  NS_LOG_ERROR (this << " Does not find BSR report info of UE " << rnti);
1966  }
1967 
1968 }
1969 
1970 void
1972 {
1973  NS_LOG_FUNCTION (this << " RNTI " << rnti << " txMode " << (uint16_t)txMode);
1975  params.m_rnti = rnti;
1976  params.m_transmissionMode = txMode;
1978 }
1979 
1980 
1981 }
std::vector< struct UlInfoListElement_s > m_ulInfoList
UL info list.
See section 4.3.1 dlDciListElement.
Definition: ff-mac-common.h:93
void UpdateDlRlcBufferInfo(uint16_t rnti, uint8_t lcid, uint16_t size)
Update DL RLC buffer info function.
Smart pointer class similar to boost::intrusive_ptr.
Definition: ptr.h:73
Service Access Point (SAP) offered by the eNodeB RRC instance to the Frequency Reuse algorithm instan...
Definition: lte-ffr-sap.h:138
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by "...
#define HARQ_PERIOD
Definition: lte-common.h:30
AttributeValue implementation for Boolean.
Definition: boolean.h:36
void DoCschedUeReleaseReq(const struct FfMacCschedSapProvider::CschedUeReleaseReqParameters &params)
CSched UE release request function.
void DoSchedDlCqiInfoReq(const struct FfMacSchedSapProvider::SchedDlCqiInfoReqParameters &params)
Sched DL CQI info request function.
uint8_t HarqProcessAvailability(uint16_t rnti)
Return the availability of free process for the RNTI specified.
#define NS_OBJECT_ENSURE_REGISTERED(type)
Register an Object subclass with the TypeId system.
Definition: object-base.h:45
Parameters of the CSCHED_UE_CONFIG_CNF primitive.
Parameters of the CSCHED_UE_RELEASE_REQ primitive.
void DoSchedDlMacBufferReq(const struct FfMacSchedSapProvider::SchedDlMacBufferReqParameters &params)
Sched DL MAC buffer request function.
void TransmissionModeConfigurationUpdate(uint16_t rnti, uint8_t txMode)
Transmission mode configuration update.
virtual void SetFfMacCschedSapUser(FfMacCschedSapUser *s)
set the user part of the FfMacCschedSap that this Scheduler will interact with.
enum ns3::UlCqi_s::Type_e m_type
type
Ptr< const AttributeAccessor > MakeBooleanAccessor(T1 a1)
Create an AttributeAccessor for a class data member, or a lone class get functor or set method...
Definition: boolean.h:84
std::vector< UlDciListElement_s > UlHarqProcessesDciBuffer_t
UL HARQ process DCI buffer vector.
LteFfrSapUser * m_ffrSapUser
FFR SAP user.
void DoSchedUlCqiInfoReq(const struct FfMacSchedSapProvider::SchedUlCqiInfoReqParameters &params)
Sched UL CQI info request function.
std::vector< struct LogicalChannelConfigListElement_s > m_logicalChannelConfigList
logicalChannelConfigList
std::vector< uint16_t > m_sinr
SINR.
uint16_t m_rnti
RNTI.
Definition: ff-mac-common.h:95
std::vector< uint8_t > DlHarqProcessesTimer_t
DL HARQ process timer vector typedef.
#define NS_ASSERT(condition)
At runtime, in debugging builds, if this condition is not true, the program prints the source file...
Definition: assert.h:67
std::vector< uint16_t > m_rachAllocationMap
RACH allocation map.
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Definition: log.h:201
std::vector< uint8_t > m_mcs
mcs
See section 4.3.2 ulDciListElement.
Provides the CSCHED SAP.
void DoCschedLcConfigReq(const struct FfMacCschedSapProvider::CschedLcConfigReqParameters &params)
CSched LC config request function.
std::vector< struct UlDciListElement_s > m_dciList
DCI list.
#define NS_LOG_INFO(msg)
Use NS_LOG to output a message of level LOG_INFO.
Definition: log.h:277
#define NS_FATAL_ERROR(msg)
Report a fatal error with a message and terminate.
Definition: fatal-error.h:162
See section 4.3.10 buildRARListElement.
uint32_t m_cqiTimersThreshold
of TTIs for which a CQI can be considered valid
virtual LteFfrSapUser * GetLteFfrSapUser()
Parameters of the CSCHED_UE_CONFIG_UPDATE_IND primitive.
static TypeId GetTypeId(void)
Get the type ID.
Parameters of the CSCHED_LC_RELEASE_REQ primitive.
void RefreshHarqProcesses()
Refresh HARQ processes according to the timers.
std::vector< std::vector< struct RlcPduListElement_s > > m_rlcPduList
RLC PDU list.
Implements the SCHED SAP and CSCHED SAP for a Frequency Domain Maximize Throughput scheduler...
Parameters of the SCHED_DL_TRIGGER_REQ primitive.
std::map< uint16_t, DlHarqRlcPduListBuffer_t > m_dlHarqProcessesRlcPduListBuffer
DL HARQ process RLC PDU list buffer.
std::vector< struct RachListElement_s > m_rachList
RACH list.
uint8_t m_rbLen
length
uint8_t m_harqProcess
HARQ process.
std::map< uint16_t, DlHarqProcessesStatus_t > m_dlHarqProcessesStatus
DL HARQ process status.
void DoCschedUeConfigReq(const struct FfMacCschedSapProvider::CschedUeConfigReqParameters &params)
CSched UE config request function.
virtual void DoDispose(void)
Destructor implementation.
std::vector< RlcPduList_t > DlHarqRlcPduListBuffer_t
vector of the 8 HARQ processes per UE
Parameters of the SCHED_DL_MAC_BUFFER_REQ primitive.
Parameters of the SCHED_DL_PAGING_BUFFER_REQ primitive.
virtual void CschedUeConfigUpdateInd(const struct CschedUeConfigUpdateIndParameters &params)=0
CSCHED_UE_UPDATE_IND.
static const int FdMtType0AllocationRbg[4]
FdMtType0AllocationRbg size array.
std::map< uint16_t, DlHarqProcessesDciBuffer_t > m_dlHarqProcessesDciBuffer
DL HARQ process DCI buffer.
std::vector< struct VendorSpecificListElement_s > m_vendorSpecificList
vendor specific list
uint8_t m_aggrLevel
aggr level
std::vector< DlInfoListElement_s > m_dlInfoListBuffered
HARQ retx buffered.
int GetRbgSize(int dlbandwidth)
Get RBG size function.
void DoSchedDlRlcBufferReq(const struct FfMacSchedSapProvider::SchedDlRlcBufferReqParameters &params)
Sched DL RLC buffer request function.
unsigned int LcActivePerFlow(uint16_t rnti)
LC Active per flow function.
Service Access Point (SAP) offered by the Frequency Reuse algorithm instance to the MAC Scheduler ins...
Definition: lte-ffr-sap.h:39
Parameters of the SCHED_UL_TRIGGER_REQ primitive.
uint32_t m_rbBitmap
rb bitmap
Definition: ff-mac-common.h:96
void DoSchedUlTriggerReq(const struct FfMacSchedSapProvider::SchedUlTriggerReqParameters &params)
Sched UL trigger request function.
Hold an unsigned integer type.
Definition: uinteger.h:44
static uint8_t TxMode2LayerNum(uint8_t txMode)
Transmit mode 2 layer number.
Definition: lte-common.cc:212
bool m_cqiRequest
CQI request.
double EstimateUlSinr(uint16_t rnti, uint16_t rb)
Estimate UL SNR function.
std::vector< uint8_t > m_ndi
ndi
uint8_t m_cceIndex
CCE index.
Provides the SCHED SAP.
FfMacCschedSapProvider * m_cschedSapProvider
csched SAP provider
virtual void CschedUeConfigCnf(const struct CschedUeConfigCnfParameters &params)=0
CSCHED_UE_CONFIG_CNF.
void RefreshUlCqiMaps(void)
Refresh UL CGI maps function.
std::vector< uint8_t > m_logicalChannelIdentity
logical channel identity
Parameters of the SCHED_UL_NOISE_INTERFERENCE_REQ primitive.
uint8_t m_logicalChannelIdentity
logical channel indentity
std::vector< struct CqiListElement_s > m_cqiList
CQI list.
std::vector< struct DlInfoListElement_s > m_dlInfoList
DL info list.
void DoSchedUlNoiseInterferenceReq(const struct FfMacSchedSapProvider::SchedUlNoiseInterferenceReqParameters &params)
Sched UL noise interference request function.
virtual FfMacSchedSapProvider * GetFfMacSchedSapProvider()
virtual void SchedDlConfigInd(const struct SchedDlConfigIndParameters &params)=0
SCHED_DL_CONFIG_IND.
std::map< uint16_t, uint32_t > m_a30CqiTimers
Map of UE's timers on DL CQI A30 received.
int8_t m_pdcchPowerOffset
CCH power offset.
std::set< uint16_t > m_flowStatsDl
Set of UE statistics (per RNTI basis) in downlink.
virtual FfMacCschedSapProvider * GetFfMacCschedSapProvider()
std::vector< uint16_t > m_tbsSize
tbs size
Definition: ff-mac-common.h:99
See section 4.3.9 rlcPDU_ListElement.
std::set< uint16_t > m_flowStatsUl
Set of UE statistics (per RNTI basis)
Every class exported by the ns3 library is enclosed in the ns3 namespace.
void DoCschedLcReleaseReq(const struct FfMacCschedSapProvider::CschedLcReleaseReqParameters &params)
CSched LC release request function.
std::map< uint16_t, uint8_t > m_dlHarqCurrentProcessId
DL HARQ current process ID.
virtual ~FdMtFfMacScheduler()
Destructor.
Ptr< const AttributeChecker > MakeBooleanChecker(void)
Definition: boolean.cc:121
std::map< uint16_t, UlHarqProcessesDciBuffer_t > m_ulHarqProcessesDciBuffer
UL HARQ process DCI buffer.
uint8_t m_freqHopping
freq hopping
std::vector< DlDciListElement_s > DlHarqProcessesDciBuffer_t
DL HARQ process DCI buffer vector typedef.
Parameters of the CSCHED_LC_CONFIG_REQ primitive.
std::map< uint16_t, uint8_t > m_ulHarqCurrentProcessId
UL HARQ current process ID.
FfMacSchedSapUser * m_schedSapUser
sched SAP user
std::map< uint16_t, SbMeasResult_s > m_a30CqiRxed
Map of UE's DL CQI A30 received.
bool m_harqOn
m_harqOn when false inhibit tte HARQ mechanisms (by default active)
std::vector< uint8_t > m_rv
rv
FfMacCschedSapUser * m_cschedSapUser
csched SAP user
std::map< uint16_t, std::vector< double > > m_ueCqi
Map of UEs' UL-CQI per RBG.
MemberCschedSapProvider class.
virtual void SchedUlConfigInd(const struct SchedUlConfigIndParameters &params)=0
SCHED_UL_CONFIG_IND.
uint8_t m_ulIndex
UL index.
LteFfrSapProvider * m_ffrSapProvider
FFR SAP provider.
NS_LOG_LOGIC("Net device "<< nd<< " is not bridged")
std::map< uint16_t, uint8_t > m_uesTxMode
txMode of the UEs
UlCqiFilter_t m_ulCqiFilter
UL CQI filter.
std::map< uint16_t, std::vector< uint16_t > > m_allocationMaps
Map of previous allocated UE per RBG (used to retrieve info from UL-CQI)
void RefreshDlCqiMaps(void)
Refresh DL CGI maps function.
#define SRS_CQI_RNTI_VSP
This abstract base class identifies the interface by means of which the helper object can plug on the...
#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
FfMacCschedSapUser class.
uint8_t UpdateHarqProcessId(uint16_t rnti)
Update and return a new process Id for the RNTI specified.
uint8_t m_nrOfPdcchOfdmSymbols
number of PDCCH OFDM symbols
void UpdateUlRlcBufferInfo(uint16_t rnti, uint16_t size)
Update UL RLC b uffer info function.
Parameters of the SCHED_DL_CQI_INFO_REQ primitive.
std::vector< struct MacCeListElement_s > m_macCeList
MAC CE list.
std::vector< struct RachListElement_s > m_rachList
RACH list.
uint8_t m_ulGrantMcs
MCS for UL grant (default 0)
static double fpS11dot3toDouble(uint16_t val)
Convert from fixed point S11.3 notation to double.
Definition: lte-common.cc:155
uint8_t m_n2Dmrs
n2 DMRS
std::vector< uint8_t > UlHarqProcessesStatus_t
UL HARQ process status vector.
std::vector< uint8_t > DlHarqProcessesStatus_t
DL HARQ process status vector typedef.
Parameters of the SCHED_UL_CQI_INFO_REQ primitive.
std::map< LteFlowId_t, FfMacSchedSapProvider::SchedDlRlcBufferReqParameters > m_rlcBufferReq
Vectors of UE's LC info.
static uint32_t BsrId2BufferSize(uint8_t val)
Convert BSR ID to buffer size.
Definition: lte-common.cc:184
LteFlowId structure.
Definition: lte-common.h:36
std::map< uint16_t, uint32_t > m_ueCqiTimers
Map of UEs' timers on UL-CQI per RBG.
std::map< uint16_t, uint32_t > m_p10CqiTimers
Map of UE's timers on DL CQI P01 received.
Parameters of the SCHED_UL_MAC_CTRL_INFO_REQ primitive.
FfMacCschedSapProvider::CschedCellConfigReqParameters m_cschedCellConfig
sched cell config
#define NS_LOG_DEBUG(msg)
Use NS_LOG to output a message of level LOG_DEBUG.
Definition: log.h:269
std::map< uint16_t, uint8_t > m_p10CqiRxed
Map of UE's DL CQI P01 received.
Parameters of the SCHED_UL_SR_INFO_REQ primitive.
std::map< uint16_t, DlHarqProcessesTimer_t > m_dlHarqProcessesTimer
DL HARDQ process timer.
void DoSchedUlSrInfoReq(const struct FfMacSchedSapProvider::SchedUlSrInfoReqParameters &params)
Sched UL SR infor request function.
#define NS_LOG_ERROR(msg)
Use NS_LOG to output a message of level LOG_ERROR.
Definition: log.h:253
Parameters of the SCHED_DL_RACH_INFO_REQ primitive.
Parameters of the SCHED_UL_CONFIG_IND primitive.
MemberSchedSapProvider class.
void DoSchedDlTriggerReq(const struct FfMacSchedSapProvider::SchedDlTriggerReqParameters &params)
Sched DL trigger request function.
Parameters of the CSCHED_UE_CONFIG_REQ primitive.
void DoSchedUlMacCtrlInfoReq(const struct FfMacSchedSapProvider::SchedUlMacCtrlInfoReqParameters &params)
Sched UL MAC control info request function.
#define HARQ_DL_TIMEOUT
#define NO_SINR
struct DlDciListElement_s m_dci
DCI.
std::vector< struct BuildRarListElement_s > m_buildRarList
build rar list
void DoSchedDlPagingBufferReq(const struct FfMacSchedSapProvider::SchedDlPagingBufferReqParameters &params)
Sched DL paging buffer request function.
Ptr< const AttributeAccessor > MakeUintegerAccessor(T1 a1)
Create an AttributeAccessor for a class data member, or a lone class get functor or set method...
Definition: uinteger.h:45
a unique identifier for an interface.
Definition: type-id.h:58
uint8_t m_resAlloc
res allocate
Definition: ff-mac-common.h:98
virtual void SetLteFfrSapProvider(LteFfrSapProvider *s)
Set the Provider part of the LteFfrSap that this Scheduler will interact with.
TypeId SetParent(TypeId tid)
Set the parent TypeId.
Definition: type-id.cc:914
void DoSchedDlRachInfoReq(const struct FfMacSchedSapProvider::SchedDlRachInfoReqParameters &params)
Sched DL RACH info request function.
#define HARQ_PROC_NUM
std::map< uint16_t, uint32_t > m_ceBsrRxed
Map of UE's buffer status reports received.
FfMacSchedSapUser class.
uint16_t m_nextRntiUl
RNTI of the next user to be served next scheduling in UL.
virtual void SetFfMacSchedSapUser(FfMacSchedSapUser *s)
set the user part of the FfMacSchedSap that this Scheduler will interact with.
std::vector< struct BuildDataListElement_s > m_buildDataList
build data list
std::map< uint16_t, UlHarqProcessesStatus_t > m_ulHarqProcessesStatus
UL HARQ process status.
uint8_t m_ueTxAntennaSelection
UE antenna selection.
FfMacSchedSapProvider * m_schedSapProvider
sched SAP provider
See section 4.3.8 builDataListElement.
void DoCschedCellConfigReq(const struct FfMacCschedSapProvider::CschedCellConfigReqParameters &params)
Csched cell config request function.