Difference between revisions of "GSOC2012LTEScheduling"

From Nsnam
Jump to: navigation, search
(LTE Scheduling with the FemtoForum MAC Scheduler API)
Line 143: Line 143:
* '''Week 14 : Aug.20 -- Aug.24'''
* '''Week 14 : Aug.20 -- Aug.24'''
   * Final report
   * Final report
I would like to express my special thanks of gratitude to my two mentors, Nicola Baldo and Marco Miozzo, also thanks of Lalith Suresh, Tom Henderson and Biljana Bojovic. Thanks for their valuable comments and helps on my work.

Revision as of 03:27, 23 August 2012

LTE Scheduling with the FemtoForum MAC Scheduler API

  • Student: Dizhi Zhou
  • Mentors: : Nicola Baldo, Marco Miozzo
  • Abstract: The ns-3 LTE module released by the LENA project supports the FemtoForum MAC LTE MAC Scheduler Interface Specification for the implementation of MAC schedulers. Currently, only simple Round Robin and Proportional Fair schedulers are supported. This project will develop several main MAC schedulers for LTE. It also includes corresponding test suites and user manual. The complete proposal can be found in here.
  • Code: http://code.nsnam.org/dizhizhou/gsoc-lte-mac-scheduler/ns-3-dev
  • Midterm report: https://www.nsnam.org/wiki/index.php/GSOC2012LTEScheduling/MidTermReport
  • About me: I'm a Ph.D. student in the University of New Brunswick, Canada. My research interests are multipath transmission for video streaming in cooperative wireless network and network simulation. You can find more information about my research in here.


LTE packet scheduler list

  • 1, Maximum Throughput (MT)[2]: eNB serves the users with largest instantaneous supportable data rate which can be caculated by cqi (user GetMcsFromCqi () and GetTbSizeFromMcs function)
  • 2, Blind Equal Throughput (BET)[2]: it reachs same throughput for all users, regardless of their radio channel quality. The priority is the reciprocal of past average throughput which can be get by lastAveragedThroughput field in pfsFlowPerf_t.
  • 3, Throughput to Average (TTA)[8]: averaging the resources evenly between the users. NOTE: TTA can only be used in frequency domain.
  • 4, Adaptive Token Bucket (TBFQ)[5]: flows belonging to UEs that are suffering from severe interference, and shadowing conditions in particular, will have a higher priority index.
  • 5, Priority set scheduling (PSS)[4]: this is the scheduler for TD which aims at providing a defined Target Bit Rate (TBR) to all users. Specifically, in TD scheduler part, the scheduler first sets all available users into two sets based on the target bit rate (TBR): set 1: users below TBR, use TD-BET; set 2: users above TBR, use TD-PF; Users belonged to set 1 have higher priority than ones in set 2. In NS-3, the m_eRabGuaranteedBitrateUL and m_eRabGuaranteedBitrateDl can be used as values to compare the TBR defined by the simulator. For example, for downlink scheduler, if m_eRabGuaranteedBitrateUL is smaller than TBR we set in script, then the MAC layer will use TD-BET scheduler in this case.

Scheduler strcture

Each scheduler has two versions: time-domain and frequency domain. The scheduler for LTE consists of two parts: TD-PS and FD-PS. TD-PS can select which user can be served for one TTI based on varied priority metrics, such as RR, PF, BET and so on. The output of TD-PS is a group of user, called scheduling candidate set (SCS). Then FD-PS will allocate RBs for those users (the SCS will also be limited by the number of PDCCHs). It seems that, in the current implementation of RR and PF schedulers for LENA LTE, only FD-PS is used. Therefore, I plan to define a TD-PS + FD-PS scheduler structure in this GSoC project. In related work, some researchers compare the performance of using different priority metric combinations for above scheduler structure. For example, in paper [2], authors evaluate the performance of TD-PF/FD-PF, TD-BET/TD-TTA, TD-MT/FD-MT.

In this GSoC project, one of my idea is that I can develop TD-PS and FD-PS independently with varied priority metrics. Users can selcet their own combinations based on the available PS models.

Development methodology

for each scheduler s
   write design documentation of s
   find reference throughput for s
   implement s
   write test code for s
   write test documentation for s
   publish code of s in public repository
   submit code of s for review using the codereview tool

Testing approach

Becasue this GSoC project is an extension of current LTE MAC scheduler implementations, the test approach will follow the system test part in [6], test suites for each scheduler will be created as:

  • 1, compare the throughput performance obtained from simulation to the reference throughput. If their values are within a given tolerance, then test is passed.
   Test case: one eNB, multiple UEs
   For single test case, all UEs have same SINR (same distance to eNB)
   For different test case, each UE has different SINR (different distance to eNB)    and different number of UE
  • 2, check the fairness of scheduler: compare the throughput ratiro get from simulation to the reference throughput ratio
  Test case: one eNB, multiple UEs
  For single test case, all UEs have different SINR different distance to eNB)     


  • [1]Kwan, R. and C. Leung, A survey of scheduling and interference mitigation in LTE. JECE, 2010. 2010: p. 1-10.
  • [2]Kela, P., et al. Dynamic packet scheduling performance in UTRA Long Term Evolution downlink. in Wireless Pervasive Computing, 2008. ISWPC 2008. 3rd International Symposium on. 2008.
  • [3]Giuseppe Piro, Luigi Alfredo Grieco, Gennaro Boggia, Rossella Fortuna, and Pietro Camarda, Two-level downlink scheduling for real-time multimedia services in LTE networks, IEEE * Trans. Multimedia, vol. 13, no. 5, pp. 1052 - 1065, Oct., 2011
  • [4]Mongha, G., et al. QoS Oriented Time and Frequency Domain Packet Schedulers for The UTRAN Long Term Evolution. in Vehicular Technology Conference, 2008. VTC Spring 2008.
  • [5]F. A. Bokhari, H. Yanikomeroglu, W. K. Wong, and M. Rahman, “Cross-layer resource scheduling for video traffic in the downlink of OFDMA-based wireless 4G networks,” EURASIP J. Wirel. Commun. Netw., pp. 1–10, 2009.
  • [6]LTE Simulator Documentation Release M4, 2011
  • [7]FemtoForum MAC LTE MAC Scheduler Interface Specification
  • [8]B. Sadiq, R. Madan, and A. Sampath, Downlink scheduling for multiclass traffic in LTE, EURASIP Journal on Wireless Communications andNetworking, vol. 2009, Article ID510617, 2009
  • [9]G. Monghal, K. I. Pedersen, I. Z. Kov´acs, and P. E. Mogensen, QoS oriented time and frequency domain packet schedulers for the UTRAN long term evolution, in Proceedings of the IEEEVehicular Technology Conference (VTC 2008), pp. 2532– 2536, 2008.
  • [10]D. López-Pérez, A. Ladanyi, A. Jüttner, H. Rivano and J. Zhang, Optimization Method for the Joint Allocation of Modulation Schemes, Coding Rates, Resource Blocks and Power in Self-Organizing LTE Networks, IEEE INFOCOM (International Conference on Computer Communications), Shanghai, China, April 2011


  • Test suites of above schedulers;
  • Documentation of above schedulers;


  • Week 1 May.21 -- May.27: FD-MT scheduler
  • Week 2 May.28 -- Jun.03: TD-MT scheduler
  • Week 3 Jun.4 -- Jun.10: FD-TTA scheduler
  • Week 4 Jun.11 -- Jun.17: FD-BET scheduler
  • Week 5 Jun.18 -- Jun.24: TD-BET scheduler
  • Week 6 Jun.25 -- Jul.01: FD-PO scheduler
  • Week 7 Jul.02 -- Jul.08: TD-PO scheduler
  • Week 8 Jul.09 -- Jul.15: Mid-term report
  • Week 9 Jul.16 -- Jul.22: FD-TBFQ scheduler
  • Week 10 Jul.23 -- Jul.29: TD-TBFQ scheduler
  • Week 11 Jul.30 -- Aug.5: FD-TBFQ scheduler
  • Week 12 Aug.06 -- Aug.12: TD-PSS scheduler
  • Week 13 Aug.13 -- Aug.19: Final report

All schedulers will follow the procedures in Development methodology section.

Weekly Progress

  • Week 1 : May.21 -- May.27
 * Complete code reading for LTE MAC scheduler and related part. Draw class relationship figure for MAC scheduler. Learning background knowledge of OFDMA
 * Write design documentation of FD-MT (including reference throughput) and scheduler framework 
  • Week 2 : May.28 -- Jun.03
 * Complete FD-MT documentation and code and submit it to codereview.
 * Get review from mentors on FD-MT code. 
  • Week 3 : Jun.4 -- Jun.10
 * Modify FD-MT documentation and code based on mentors' comment
 * Complete  TD-MT documentation and code and submit it to internal code review by mentors
 * Complete FD-TTA design 
  • Week 4 : Jun.11 -- Jun.17
 * Complete TTA scheduler, including code, testing and documentation
 * Complete TD-BET and test it in the same SINR testcase.
 * Complete design document of FD-BET
  • Week 5 : Jun.18 -- Jun.24
 * Complete FD-BET, including code, test case 1
  • Week 6 : Jun.25 -- Jul.01
 * Modify the MT, TTA and BET codes based on naming style in NS-3
 * Propose a proof method for the user throughput calculation in FD-BET testcase 2 
  • Week 7 : Jul.02 -- Jul.08
 * Complete all FD-BET test case and documentation
  • Week 8 : Jul.09 -- Jul.15
 * Midterm report [[1]]
  • Week 9 : Jul.16 -- Jul.22
 * Read four background papers of FBFQ scheduler in ATM, TDMA and LTE network
 * Complete first version of FD FBFQ scheduler 
  • Week 10 : Jul.23 -- Jul.29
 * Implement FD FBFQ scheduler for realistic application; several design issues faced, Unnecessary RBG allocation, GBR configuration and RLC packet header calculation
 * FD FBFQ testsuites for homogeneous traffic flows (traffic with the same sending rate) 
  • Week 11 : Jul.30 -- Aug.5
 * Complete FD TBFQ scheduler, including scheduler codes and testsuites
 * Complete TD TBFQ scheduler, including scheduler codes and testsuites 
  • Week 12 : Aug.06 -- Aug.12
 * Complete first version of PSS:
      TD scheduler: TD-BET + TD-PF
      FD scheduler: CoItA
 * Complete TBFQ document 
  • Week 13 : Aug.13 -- Aug.19
 * Complete FD-PFsch model in PSS scheduler
 * Complete testcase and document for PSS scheduler 
  • Week 14 : Aug.20 -- Aug.24
 * Final report


I would like to express my special thanks of gratitude to my two mentors, Nicola Baldo and Marco Miozzo, also thanks of Lalith Suresh, Tom Henderson and Biljana Bojovic. Thanks for their valuable comments and helps on my work.