lte-enb-mac.h

Go to the documentation of this file.

/* -*-  Mode: C++; c-file-style: "gnu"; indent-tabs-mode:nil; -*- */
/*
 * Copyright (c) 2011 Centre Tecnologic de Telecomunicacions de Catalunya (CTTC)
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License version 2 as
 * published by the Free Software Foundation;
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 *
 * Author: Marco Miozzo  <marco.miozzo@cttc.es>
 *         Nicola Baldo  <nbaldo@cttc.es>
 * Modified by:
 *          Danilo Abrignani <danilo.abrignani@unibo.it> (Carrier Aggregation - GSoC 2015)
 *          Biljana Bojovic <biljana.bojovic@cttc.es> (Carrier Aggregation)
 */

#ifndef LTE_ENB_MAC_H
#define LTE_ENB_MAC_H


#include <map>
#include <vector>
#include <ns3/lte-common.h>
#include <ns3/lte-mac-sap.h>
#include <ns3/lte-enb-cmac-sap.h>
#include <ns3/ff-mac-csched-sap.h>
#include <ns3/ff-mac-sched-sap.h>
#include <ns3/lte-enb-phy-sap.h>
#include "ns3/traced-value.h"
#include "ns3/trace-source-accessor.h"
#include <ns3/packet.h>
#include <ns3/packet-burst.h>
#include <ns3/lte-ccm-mac-sap.h>

namespace ns3 {

class DlCqiLteControlMessage;
class UlCqiLteControlMessage;
class PdcchMapLteControlMessage;

typedef std::vector <std::vector < Ptr<PacketBurst> > > DlHarqProcessesBuffer_t;

class LteEnbMac :   public Object
{
  friend class EnbMacMemberLteEnbCmacSapProvider;
  friend class EnbMacMemberLteMacSapProvider<LteEnbMac>;
  friend class EnbMacMemberFfMacSchedSapUser;
  friend class EnbMacMemberFfMacCschedSapUser;
  friend class EnbMacMemberLteEnbPhySapUser;
  friend class MemberLteCcmMacSapProvider<LteEnbMac>;

public:
  static TypeId GetTypeId (void);

  LteEnbMac (void);
  virtual ~LteEnbMac (void);
  virtual void DoDispose (void);

  void SetComponentCarrierId (uint8_t index);
  void SetFfMacSchedSapProvider (FfMacSchedSapProvider* s);
  FfMacSchedSapUser* GetFfMacSchedSapUser (void);
  void SetFfMacCschedSapProvider (FfMacCschedSapProvider* s);
  FfMacCschedSapUser* GetFfMacCschedSapUser (void);



  void SetLteMacSapUser (LteMacSapUser* s);
  LteMacSapProvider* GetLteMacSapProvider (void);
  void SetLteEnbCmacSapUser (LteEnbCmacSapUser* s);
  LteEnbCmacSapProvider* GetLteEnbCmacSapProvider (void);


  LteEnbPhySapUser* GetLteEnbPhySapUser ();

  void SetLteEnbPhySapProvider (LteEnbPhySapProvider* s);

  LteCcmMacSapProvider* GetLteCcmMacSapProvider ();

  void SetLteCcmMacSapUser (LteCcmMacSapUser* s);
  

  typedef void (* DlSchedulingTracedCallback)
    (const uint32_t frame, const uint32_t subframe, const uint16_t rnti,
     const uint8_t mcs0, const uint16_t tbs0Size,
     const uint8_t mcs1, const uint16_t tbs1Size, const uint8_t ccId);

  typedef void (* UlSchedulingTracedCallback)
    (const uint32_t frame, const uint32_t subframe, const uint16_t rnti,
     const uint8_t mcs, const uint16_t tbsSize);
  
private:

  void ReceiveDlCqiLteControlMessage  (Ptr<DlCqiLteControlMessage> msg);

  void DoReceiveLteControlMessage (Ptr<LteControlMessage> msg);

  void ReceiveBsrMessage  (MacCeListElement_s bsr);

  void DoUlCqiReport (FfMacSchedSapProvider::SchedUlCqiInfoReqParameters ulcqi);



  // forwarded from LteEnbCmacSapProvider
  void DoConfigureMac (uint16_t ulBandwidth, uint16_t dlBandwidth);
  void DoAddUe (uint16_t rnti);
  void DoRemoveUe (uint16_t rnti);
  void DoAddLc (LteEnbCmacSapProvider::LcInfo lcinfo, LteMacSapUser* msu);
  void DoReconfigureLc (LteEnbCmacSapProvider::LcInfo lcinfo);
  void DoReleaseLc (uint16_t  rnti, uint8_t lcid);
  void DoUeUpdateConfigurationReq (LteEnbCmacSapProvider::UeConfig params);
  LteEnbCmacSapProvider::RachConfig DoGetRachConfig ();
  LteEnbCmacSapProvider::AllocateNcRaPreambleReturnValue DoAllocateNcRaPreamble (uint16_t rnti);

  // forwarded from LteMacSapProvider
  void DoTransmitPdu (LteMacSapProvider::TransmitPduParameters params);
  void DoReportBufferStatus (LteMacSapProvider::ReportBufferStatusParameters params);


  // forwarded from FfMacCchedSapUser
  void DoCschedCellConfigCnf (FfMacCschedSapUser::CschedCellConfigCnfParameters params);
  void DoCschedUeConfigCnf (FfMacCschedSapUser::CschedUeConfigCnfParameters params);
  void DoCschedLcConfigCnf (FfMacCschedSapUser::CschedLcConfigCnfParameters params);
  void DoCschedLcReleaseCnf (FfMacCschedSapUser::CschedLcReleaseCnfParameters params);
  void DoCschedUeReleaseCnf (FfMacCschedSapUser::CschedUeReleaseCnfParameters params);
  void DoCschedUeConfigUpdateInd (FfMacCschedSapUser::CschedUeConfigUpdateIndParameters params);
  void DoCschedCellConfigUpdateInd (FfMacCschedSapUser::CschedCellConfigUpdateIndParameters params);

  // forwarded from FfMacSchedSapUser
  void DoSchedDlConfigInd (FfMacSchedSapUser::SchedDlConfigIndParameters ind);
  void DoSchedUlConfigInd (FfMacSchedSapUser::SchedUlConfigIndParameters params);

  // forwarded from LteEnbPhySapUser
  void DoSubframeIndication (uint32_t frameNo, uint32_t subframeNo);
  void DoReceiveRachPreamble (uint8_t prachId);

  // forwarded by LteCcmMacSapProvider
  void DoReportMacCeToScheduler (MacCeListElement_s bsr);

  void DoReportSrToScheduler (uint16_t rnti)
  {
    NS_UNUSED (rnti);
  }
  
public:
  void DoReceivePhyPdu (Ptr<Packet> p);

private:
  void DoUlInfoListElementHarqFeeback (UlInfoListElement_s params);
  void DoDlInfoListElementHarqFeeback (DlInfoListElement_s params);

  std::map <uint16_t, std::map<uint8_t, LteMacSapUser*> > m_rlcAttached;

  std::vector <CqiListElement_s> m_dlCqiReceived; 
  std::vector <FfMacSchedSapProvider::SchedUlCqiInfoReqParameters> m_ulCqiReceived; 
  std::vector <MacCeListElement_s> m_ulCeReceived; 

  std::vector <DlInfoListElement_s> m_dlInfoListReceived; 

  std::vector <UlInfoListElement_s> m_ulInfoListReceived; 


  /*
  * Map of UE's info element (see 4.3.12 of FF MAC Scheduler API)
  */
  //std::map <uint16_t,UlInfoListElement_s> m_ulInfoListElements; 



  LteMacSapProvider* m_macSapProvider; 
  LteEnbCmacSapProvider* m_cmacSapProvider; 
  LteMacSapUser* m_macSapUser; 
  LteEnbCmacSapUser* m_cmacSapUser; 


  FfMacSchedSapProvider* m_schedSapProvider; 
  FfMacCschedSapProvider* m_cschedSapProvider; 
  FfMacSchedSapUser* m_schedSapUser; 
  FfMacCschedSapUser* m_cschedSapUser; 

  // PHY-SAP
  LteEnbPhySapProvider* m_enbPhySapProvider; 
  LteEnbPhySapUser* m_enbPhySapUser; 

  // Sap For ComponentCarrierManager 'Uplink case'
  LteCcmMacSapProvider* m_ccmMacSapProvider; 
  LteCcmMacSapUser* m_ccmMacSapUser; 

  uint32_t m_frameNo;
  uint32_t m_subframeNo;
  TracedCallback<DlSchedulingCallbackInfo> m_dlScheduling;

  TracedCallback<uint32_t, uint32_t, uint16_t,
                 uint8_t, uint16_t, uint8_t> m_ulScheduling;
  
  uint8_t m_macChTtiDelay; 


  std::map <uint16_t, DlHarqProcessesBuffer_t> m_miDlHarqProcessesPackets; 
  
  uint8_t m_numberOfRaPreambles; 
  uint8_t m_preambleTransMax; 
  uint8_t m_raResponseWindowSize; 
  uint8_t m_connEstFailCount; 

  struct NcRaPreambleInfo
  {   
    uint16_t rnti; 
    Time expiryTime; 
  };

  std::map<uint8_t, NcRaPreambleInfo> m_allocatedNcRaPreambleMap;
 
  std::map<uint8_t, uint32_t> m_receivedRachPreambleCount; 

  std::map<uint16_t, uint32_t> m_rapIdRntiMap; 

  uint8_t m_componentCarrierId;
 
};

} // end namespace ns3

#endif /* LTE_ENB_MAC_ENTITY_H */