bs-net-device.h

/* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
/*
 * Copyright (c) 2007,2008, 2009 INRIA, UDcast
 *
 * 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
 *
 * Authors: Jahanzeb Farooq <jahanzeb.farooq@sophia.inria.fr>
 *          Mohamed Amine Ismail <amine.ismail@sophia.inria.fr>
 */

#ifndef WIMAX_BS_NET_DEVICE_H
#define WIMAX_BS_NET_DEVICE_H

#include "wimax-net-device.h"
#include "ns3/event-id.h"
#include "wimax-connection.h"
#include "ns3/nstime.h"
#include "ns3/mac48-address.h"
#include "ns3/ipv4-address.h"
#include "ns3/bs-service-flow-manager.h"
#include "dl-mac-messages.h"
#include "ipcs-classifier.h"

namespace ns3 {

class Node;
class Packet;
class SSRecord;
class SSManager;
class BSScheduler;
class BurstProfileManager;
class BSLinkManager;
class UplinkScheduler;
class BsServiceFlowManager;

class BaseStationNetDevice : public WimaxNetDevice
{
public:
  enum State
  {
    BS_STATE_DL_SUB_FRAME, BS_STATE_UL_SUB_FRAME, BS_STATE_TTG, BS_STATE_RTG
  };

  enum MacPreamble
  {
    SHORT_PREAMBLE = 1, LONG_PREAMBLE
  };

  static TypeId GetTypeId (void);
  BaseStationNetDevice (void);
  BaseStationNetDevice (Ptr<Node> node, Ptr<WimaxPhy> phy);
  BaseStationNetDevice (Ptr<Node> node,
                        Ptr<WimaxPhy> phy,
                        Ptr<UplinkScheduler> uplinkScheduler,
                        Ptr<BSScheduler> bsScheduler);
  ~BaseStationNetDevice (void);
  void SetInitialRangingInterval (Time initialRangInterval);
  void InitBaseStationNetDevice (void);
  Time GetInitialRangingInterval (void) const;
  void SetDcdInterval (Time dcdInterval);
  Time GetDcdInterval (void) const;
  void SetUcdInterval (Time ucdInterval);
  Time GetUcdInterval (void) const;
  void SetIntervalT8 (Time interval);
  Time GetIntervalT8 (void) const;
  void SetMaxRangingCorrectionRetries (uint8_t maxRangCorrectionRetries);
  uint8_t GetMaxRangingCorrectionRetries (void) const;
  void SetMaxInvitedRangRetries (uint8_t maxInvitedRangRetries);
  uint8_t GetMaxInvitedRangRetries (void) const;
  void SetRangReqOppSize (uint8_t rangReqOppSize);
  uint8_t GetRangReqOppSize (void) const;
  void SetBwReqOppSize (uint8_t bwReqOppSize);
  uint8_t GetBwReqOppSize (void) const;
  void SetNrDlSymbols (uint32_t dlSymbols);
  uint32_t GetNrDlSymbols (void) const;
  void SetNrUlSymbols (uint32_t ulSymbols);
  uint32_t GetNrUlSymbols (void) const;
  uint32_t GetNrDcdSent (void) const;
  uint32_t GetNrUcdSent (void) const;

  Time GetDlSubframeStartTime (void) const;
  Time GetUlSubframeStartTime (void) const;
  uint8_t GetRangingOppNumber (void) const;
  Ptr<SSManager> GetSSManager (void) const;
  void SetSSManager (Ptr<SSManager> ssManager);
  Ptr<UplinkScheduler> GetUplinkScheduler (void) const;
  void SetUplinkScheduler (Ptr<UplinkScheduler> ulScheduler);
  Ptr<BSLinkManager> GetLinkManager (void) const;
  void SetBSScheduler (Ptr<BSScheduler> bsSchedule);
  Ptr<BSScheduler> GetBSScheduler (void) const;

  void SetLinkManager (Ptr<BSLinkManager> linkManager);
  Ptr<IpcsClassifier> GetBsClassifier (void) const;
  void SetBsClassifier (Ptr<IpcsClassifier> classifier);

  Time GetPsDuration (void) const;
  Time GetSymbolDuration (void) const;

  void Start (void);
  void Stop (void);
  bool Enqueue (Ptr<Packet> packet, const MacHeaderType &hdrType, Ptr<WimaxConnection> connection);
  Ptr<WimaxConnection> GetConnection (Cid cid);

  void MarkUplinkAllocations (void);
  void MarkRangingOppStart (Time rangingOppStartTime);

  Ptr<BsServiceFlowManager> GetServiceFlowManager (void) const;
  void SetServiceFlowManager (Ptr<BsServiceFlowManager> );
private:
  void DoDispose (void);
  void StartFrame (void);
  void StartDlSubFrame (void);
  void EndDlSubFrame (void);
  void StartUlSubFrame (void);
  void EndUlSubFrame (void);
  void EndFrame (void);

  bool DoSend (Ptr<Packet> packet, const Mac48Address& source, const Mac48Address& dest, uint16_t protocolNumber);
  void DoReceive (Ptr<Packet> packet);
  void CreateMapMessages (void);
  void CreateDescriptorMessages (bool sendDcd, bool senUcd);
  void SendBursts (void);

  Ptr<Packet> CreateDlMap (void);
  Ptr<Packet> CreateDcd (void);
  Ptr<Packet> CreateUlMap (void);
  Ptr<Packet> CreateUcd (void);
  void SetDlBurstProfiles (Dcd *dcd);
  void SetUlBurstProfiles (Ucd *ucd);

  void MarkUplinkAllocationStart (Time allocationStartTime);
  void MarkUplinkAllocationEnd (Time allocationEndTime, Cid cid, uint8_t uiuc);
  void UplinkAllocationStart (void);
  void UplinkAllocationEnd (Cid cid, uint8_t uiuc);
  void RangingOppStart (void);

  // parameters defined in Table 342
  Time m_initialRangInterval; // in seconds
  Time m_dcdInterval; // in seconds
  Time m_ucdInterval; // in seconds
  Time m_intervalT8; // in milliseconds, wait for DSA/DSC Acknowledge timeout

  uint8_t m_maxRangCorrectionRetries;
  uint8_t m_maxInvitedRangRetries;
  uint8_t m_rangReqOppSize; // in symbols
  uint8_t m_bwReqOppSize; // in symbols

  uint32_t m_nrDlSymbols;
  uint32_t m_nrUlSymbols;

  // to keep track total number of a certain management messages sent by the BS
  uint32_t m_nrDlMapSent;
  uint32_t m_nrUlMapSent;
  // number of DCDs and UCDs sent even if same
  uint32_t m_nrDcdSent;
  uint32_t m_nrUcdSent;

  uint32_t m_dcdConfigChangeCount;
  uint32_t m_ucdConfigChangeCount;

  uint32_t m_framesSinceLastDcd;
  uint32_t m_framesSinceLastUcd;

  // uint32_t m_nrFrames; //temporarily defined in wimax-net-device, as static
  uint32_t m_nrDlFrames;
  uint32_t m_nrUlFrames;

  // to keep track if number of SSs have changed since the last frame
  uint16_t m_nrSsRegistered;

  uint16_t m_nrDlAllocations;
  uint16_t m_nrUlAllocations;

  Time m_dlSubframeStartTime;
  Time m_ulSubframeStartTime;

  uint8_t m_ulAllocationNumber; // to see UL burst number
  uint8_t m_rangingOppNumber; // current ranging TO number

  CidFactory *m_cidFactory;

  uint32_t m_allocationStartTime;

  Ptr<SSManager> m_ssManager;
  Ptr<UplinkScheduler> m_uplinkScheduler;
  Ptr<BSScheduler> m_scheduler;
  Ptr<BSLinkManager> m_linkManager;
  Ptr<IpcsClassifier> m_bsClassifier;
  Ptr<BsServiceFlowManager> m_serviceFlowManager;
  // same fields as in PHY, for quick access
  Time m_psDuration;
  Time m_symbolDuration;

  TracedCallback<Ptr<const Packet>, Mac48Address, Cid> m_traceBSRx;

  TracedCallback<Ptr<const Packet> > m_bsTxTrace;

  TracedCallback<Ptr<const Packet> > m_bsTxDropTrace;

  TracedCallback<Ptr<const Packet> > m_bsPromiscRxTrace;

  TracedCallback<Ptr<const Packet> > m_bsRxTrace;

  TracedCallback<Ptr<const Packet> > m_bsRxDropTrace;
};

} // namespace ns3

#endif /* WIMAX_BS_NET_DEVICE_H */