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