ff-mac-sched-sap.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: Manuel Requena <manuel.requena@cttc.es>
 */
 
#ifndef FF_MAC_SCHED_SAP_H
#define FF_MAC_SCHED_SAP_H
 
#include <stdint.h>
#include <vector>
 
#include "ff-mac-common.h"
 
 
namespace ns3 {
 
class FfMacSchedSapProvider
{
public:
  virtual ~FfMacSchedSapProvider ();
 
  struct SchedDlRlcBufferReqParameters
  {
    uint16_t  m_rnti; 
    uint8_t   m_logicalChannelIdentity; 
    uint32_t  m_rlcTransmissionQueueSize; 
    uint16_t  m_rlcTransmissionQueueHolDelay; 
    uint32_t  m_rlcRetransmissionQueueSize; 
    uint16_t  m_rlcRetransmissionHolDelay; 
    uint16_t  m_rlcStatusPduSize; 
 
    std::vector <struct VendorSpecificListElement_s> m_vendorSpecificList; 
  };
 
  struct SchedDlPagingBufferReqParameters
  {
    uint16_t  m_rnti; 
    std::vector <struct PagingInfoListElement_s> m_pagingInfoList; 
 
    std::vector <struct VendorSpecificListElement_s> m_vendorSpecificList; 
  };
 
  struct SchedDlMacBufferReqParameters
  {
    uint16_t  m_rnti; 
    enum CeBitmap_e m_ceBitmap; 
 
    std::vector <struct VendorSpecificListElement_s> m_vendorSpecificList; 
  };
 
  struct SchedDlTriggerReqParameters
  {
    uint16_t  m_sfnSf; 
    std::vector <struct DlInfoListElement_s> m_dlInfoList; 
 
    std::vector <struct VendorSpecificListElement_s> m_vendorSpecificList; 
  };
 
  struct SchedDlRachInfoReqParameters
  {
    uint16_t  m_sfnSf; 
    std::vector <struct RachListElement_s> m_rachList; 
 
    std::vector <struct VendorSpecificListElement_s> m_vendorSpecificList; 
  };
 
  struct SchedDlCqiInfoReqParameters
  {
    uint16_t  m_sfnSf; 
    std::vector <struct CqiListElement_s> m_cqiList; 
 
    std::vector <struct VendorSpecificListElement_s> m_vendorSpecificList; 
  };
 
  struct SchedUlTriggerReqParameters
  {
    uint16_t  m_sfnSf; 
    std::vector <struct UlInfoListElement_s> m_ulInfoList; 
 
    std::vector <struct VendorSpecificListElement_s> m_vendorSpecificList; 
  };
 
  struct SchedUlNoiseInterferenceReqParameters
  {
    uint16_t  m_sfnSf; 
    uint16_t  m_rip; 
    uint16_t  m_tnp; 
 
    std::vector <struct VendorSpecificListElement_s> m_vendorSpecificList; 
  };
 
  struct SchedUlSrInfoReqParameters
  {
    uint16_t  m_sfnSf; 
    std::vector <struct SrListElement_s> m_srList; 
 
    std::vector <struct VendorSpecificListElement_s> m_vendorSpecificList; 
  };
 
  struct SchedUlMacCtrlInfoReqParameters
  {
    uint16_t  m_sfnSf; 
    std::vector <struct MacCeListElement_s> m_macCeList; 
 
    std::vector <struct VendorSpecificListElement_s> m_vendorSpecificList; 
  };
 
  struct SchedUlCqiInfoReqParameters
  {
    uint16_t  m_sfnSf; 
    struct UlCqi_s m_ulCqi; 
 
    std::vector <struct VendorSpecificListElement_s> m_vendorSpecificList; 
  };
 
  //
  // SCHED - MAC Scheduler SAP primitives
  // (See 4.2 for description of the primitives)
  //
 
  virtual void SchedDlRlcBufferReq (const struct SchedDlRlcBufferReqParameters& params) = 0;
 
  virtual void SchedDlPagingBufferReq (const struct SchedDlPagingBufferReqParameters& params) = 0;
 
  virtual void SchedDlMacBufferReq (const struct SchedDlMacBufferReqParameters& params) = 0;
 
  virtual void SchedDlTriggerReq (const struct SchedDlTriggerReqParameters& params) = 0;
 
  virtual void SchedDlRachInfoReq (const struct SchedDlRachInfoReqParameters& params) = 0;
 
  virtual void SchedDlCqiInfoReq (const struct SchedDlCqiInfoReqParameters& params) = 0;
 
  virtual void SchedUlTriggerReq (const struct SchedUlTriggerReqParameters& params) = 0;
 
  virtual void SchedUlNoiseInterferenceReq (const struct SchedUlNoiseInterferenceReqParameters& params) = 0;
 
  virtual void SchedUlSrInfoReq (const struct SchedUlSrInfoReqParameters& params) = 0;
 
  virtual void SchedUlMacCtrlInfoReq (const struct SchedUlMacCtrlInfoReqParameters& params) = 0;
 
  virtual void SchedUlCqiInfoReq (const struct SchedUlCqiInfoReqParameters& params) = 0;
 
private:
};
 
 
class FfMacSchedSapUser
{
public:
  virtual ~FfMacSchedSapUser ();
 
  struct SchedDlConfigIndParameters
  {
    std::vector <struct BuildDataListElement_s>      m_buildDataList; 
    std::vector <struct BuildRarListElement_s>       m_buildRarList; 
    std::vector <struct BuildBroadcastListElement_s> m_buildBroadcastList; 
 
    uint8_t m_nrOfPdcchOfdmSymbols; 
 
    std::vector <struct VendorSpecificListElement_s> m_vendorSpecificList; 
  };
 
  struct SchedUlConfigIndParameters
  {
    std::vector <struct UlDciListElement_s> m_dciList; 
    std::vector <struct PhichListElement_s> m_phichList; 
 
    std::vector <struct VendorSpecificListElement_s> m_vendorSpecificList; 
  };
 
  //
  // SCHED - MAC Scheduler SAP primitives
  // (See 4.2 for description of the primitives)
  //
 
  virtual void SchedDlConfigInd (const struct SchedDlConfigIndParameters& params) = 0;
 
  virtual void SchedUlConfigInd (const struct SchedUlConfigIndParameters& params) = 0;
 
private:
};
 
 
 
template <class C>
class MemberSchedSapProvider : public FfMacSchedSapProvider
{
public:
  MemberSchedSapProvider (C* scheduler);
 
  // inherited from FfMacSchedSapProvider
  virtual void SchedDlRlcBufferReq (const struct SchedDlRlcBufferReqParameters& params);
  virtual void SchedDlPagingBufferReq (const struct SchedDlPagingBufferReqParameters& params);
  virtual void SchedDlMacBufferReq (const struct SchedDlMacBufferReqParameters& params);
  virtual void SchedDlTriggerReq (const struct SchedDlTriggerReqParameters& params);
  virtual void SchedDlRachInfoReq (const struct SchedDlRachInfoReqParameters& params);
  virtual void SchedDlCqiInfoReq (const struct SchedDlCqiInfoReqParameters& params);
  virtual void SchedUlTriggerReq (const struct SchedUlTriggerReqParameters& params);
  virtual void SchedUlNoiseInterferenceReq (const struct SchedUlNoiseInterferenceReqParameters& params);
  virtual void SchedUlSrInfoReq (const struct SchedUlSrInfoReqParameters& params);
  virtual void SchedUlMacCtrlInfoReq (const struct SchedUlMacCtrlInfoReqParameters& params);
  virtual void SchedUlCqiInfoReq (const struct SchedUlCqiInfoReqParameters& params);
 
 
private:
  MemberSchedSapProvider ();
  C* m_scheduler; 
};
 
 
template <class C>
MemberSchedSapProvider<C>::MemberSchedSapProvider ()
{
}
 
 
template <class C>
MemberSchedSapProvider<C>::MemberSchedSapProvider (C* scheduler)
  : m_scheduler (scheduler)
{
}
 
template <class C>
void
MemberSchedSapProvider<C>::SchedDlRlcBufferReq (const struct SchedDlRlcBufferReqParameters& params)
{
  m_scheduler->DoSchedDlRlcBufferReq (params);
}
 
template <class C>
void
MemberSchedSapProvider<C>::SchedDlPagingBufferReq (const struct SchedDlPagingBufferReqParameters& params)
{
  m_scheduler->DoSchedDlPagingBufferReq (params);
}
 
template <class C>
void
MemberSchedSapProvider<C>::SchedDlMacBufferReq (const struct SchedDlMacBufferReqParameters& params)
{
  m_scheduler->DoSchedDlMacBufferReq (params);
}
 
template <class C>
void
MemberSchedSapProvider<C>::SchedDlTriggerReq (const struct SchedDlTriggerReqParameters& params)
{
  m_scheduler->DoSchedDlTriggerReq (params);
}
 
template <class C>
void
MemberSchedSapProvider<C>::SchedDlRachInfoReq (const struct SchedDlRachInfoReqParameters& params)
{
  m_scheduler->DoSchedDlRachInfoReq (params);
}
 
template <class C>
void
MemberSchedSapProvider<C>::SchedDlCqiInfoReq (const struct SchedDlCqiInfoReqParameters& params)
{
  m_scheduler->DoSchedDlCqiInfoReq (params);
}
 
template <class C>
void
MemberSchedSapProvider<C>::SchedUlTriggerReq (const struct SchedUlTriggerReqParameters& params)
{
  m_scheduler->DoSchedUlTriggerReq (params);
}
 
template <class C>
void
MemberSchedSapProvider<C>::SchedUlNoiseInterferenceReq (const struct SchedUlNoiseInterferenceReqParameters& params)
{
  m_scheduler->DoSchedUlNoiseInterferenceReq (params);
}
 
template <class C>
void
MemberSchedSapProvider<C>::SchedUlSrInfoReq (const struct SchedUlSrInfoReqParameters& params)
{
  m_scheduler->DoSchedUlSrInfoReq (params);
}
 
template <class C>
void
MemberSchedSapProvider<C>::SchedUlMacCtrlInfoReq (const struct SchedUlMacCtrlInfoReqParameters& params)
{
  m_scheduler->DoSchedUlMacCtrlInfoReq (params);
}
 
template <class C>
void
MemberSchedSapProvider<C>::SchedUlCqiInfoReq (const struct SchedUlCqiInfoReqParameters& params)
{
  m_scheduler->DoSchedUlCqiInfoReq (params);
}
 
 
 
 
 
} // namespace ns3
 
#endif /* FF_MAC_SCHED_SAP_H */