ss-net-device.h

Go to the documentation of this file.

/* -*- 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>
 *                               <amine.ismail@UDcast.com>
 */

#ifndef WIMAX_SS_NET_DEVICE_H
#define WIMAX_SS_NET_DEVICE_H

#include "ns3/event-id.h"
#include "wimax-net-device.h"
#include "ns3/nstime.h"
#include "wimax-mac-header.h"
#include "ns3/uinteger.h"
#include "ns3/ss-service-flow-manager.h"
#include "ipcs-classifier.h"

namespace ns3 {

class Node;
class OfdmDlBurstProfile;
class OfdmUlBurstProfile;
class SSScheduler;
class SSLinkManager;
class SsServiceFlowManager;
class IpcsClassifier;

class SubscriberStationNetDevice : public WimaxNetDevice
{
public:
  enum State
  {
    SS_STATE_IDLE,
    SS_STATE_SCANNING,
    SS_STATE_SYNCHRONIZING,
    SS_STATE_ACQUIRING_PARAMETERS,
    SS_STATE_WAITING_REG_RANG_INTRVL, // regular ranging interval
    SS_STATE_WAITING_INV_RANG_INTRVL, // invited ranging interval
    SS_STATE_WAITING_RNG_RSP,
    SS_STATE_ADJUSTING_PARAMETERS,
    SS_STATE_REGISTERED,
    SS_STATE_TRANSMITTING, // currently not being used anywhere
    SS_STATE_STOPPED
  };

  enum EventType
  {
    EVENT_NONE,
    EVENT_WAIT_FOR_RNG_RSP,
    EVENT_DL_MAP_SYNC_TIMEOUT,
    EVENT_LOST_DL_MAP,
    EVENT_LOST_UL_MAP,
    EVENT_DCD_WAIT_TIMEOUT,
    EVENT_UCD_WAIT_TIMEOUT,
    EVENT_RANG_OPP_WAIT_TIMEOUT
  };

  static TypeId GetTypeId (void);
  SubscriberStationNetDevice (void);
  SubscriberStationNetDevice (Ptr<Node> node, Ptr<WimaxPhy> phy);
  ~SubscriberStationNetDevice (void);

  void InitSubscriberStationNetDevice (void);
  void SetLostDlMapInterval (Time lostDlMapInterval);
  Time GetLostDlMapInterval (void) const;
  void SetLostUlMapInterval (Time lostUlMapInterval);
  Time GetLostUlMapInterval (void) const;
  void SetMaxDcdInterval (Time maxDcdInterval);
  Time GetMaxDcdInterval (void) const;
  void SetMaxUcdInterval (Time maxUcdInterval);
  Time GetMaxUcdInterval (void) const;
  void SetIntervalT1 (Time interval1);
  Time GetIntervalT1 (void) const;
  void SetIntervalT2 (Time interval2);
  Time GetIntervalT2 (void) const;
  void SetIntervalT3 (Time interval3);
  Time GetIntervalT3 (void) const;
  void SetIntervalT7 (Time interval7);
  Time GetIntervalT7 (void) const;
  void SetIntervalT12 (Time interval12);
  Time GetIntervalT12 (void) const;
  void SetIntervalT20 (Time interval20);
  Time GetIntervalT20 (void) const;
  void SetIntervalT21 (Time interval21);
  Time GetIntervalT21 (void) const;
  void SetMaxContentionRangingRetries (uint8_t maxContentionRangingRetries);
  uint8_t GetMaxContentionRangingRetries (void) const;
  void SetBasicConnection (Ptr<WimaxConnection> basicConnection);
  Ptr<WimaxConnection> GetBasicConnection (void) const;
  void SetPrimaryConnection (Ptr<WimaxConnection> primaryConnection);
  Ptr<WimaxConnection> GetPrimaryConnection (void) const;
  Cid GetBasicCid (void) const;
  Cid GetPrimaryCid (void) const;

  void SetModulationType (WimaxPhy::ModulationType modulationType);
  WimaxPhy::ModulationType GetModulationType (void) const;
  void SetAreManagementConnectionsAllocated (bool areManagementConnectionsAllocated);
  bool GetAreManagementConnectionsAllocated (void) const;
  void SetAreServiceFlowsAllocated (bool areServiceFlowsAllocated);
  bool GetAreServiceFlowsAllocated (void) const;
  Ptr<SSScheduler> GetScheduler (void) const;
  void SetScheduler (Ptr<SSScheduler> ssScheduler);
  bool HasServiceFlows (void) const;
  bool Enqueue (Ptr<Packet> packet, const MacHeaderType &hdrType, Ptr<WimaxConnection> connection);
  void SendBurst (uint8_t uiuc,
                  uint16_t nrSymbols,
                  Ptr<WimaxConnection> connection,
                  MacHeaderType::HeaderType packetType = MacHeaderType::HEADER_TYPE_GENERIC);

  void Start (void);
  void Stop (void);

  void AddServiceFlow (ServiceFlow *sf);
  void AddServiceFlow (ServiceFlow sf);
  void SetTimer (EventId eventId, EventId &event);
  bool IsRegistered (void) const;
  Time GetTimeToAllocation (Time deferTime);

  Ptr<SSLinkManager> m_linkManager; 

  Ptr<IpcsClassifier> GetIpcsClassifier () const;
  void SetIpcsPacketClassifier (Ptr<IpcsClassifier> classifier);
  Ptr<SSLinkManager> GetLinkManager (void) const;
  void SetLinkManager (Ptr<SSLinkManager> linkManager);
  Ptr<SsServiceFlowManager> GetServiceFlowManager (void) const;
  void SetServiceFlowManager (Ptr<SsServiceFlowManager> sfm);

  typedef Callback<void, std::string, Ptr<const Packet> > AsciiTraceCallback;

  void SetAsciiTxQueueEnqueueCallback (AsciiTraceCallback cb);

  void SetAsciiTxQueueDequeueCallback (AsciiTraceCallback cb);

  void SetAsciiTxQueueDropCallback (AsciiTraceCallback cb);

private:
  static Time GetDefaultLostDlMapInterval ();

  void DoDispose (void);
  bool DoSend (Ptr<Packet> packet, const Mac48Address &source, const Mac48Address &dest, uint16_t protocolNumber);
  void DoReceive (Ptr<Packet> packet);

  void ProcessDlMap (const DlMap &dlmap);
  void ProcessUlMap (const UlMap &ulmap);
  void ProcessDcd (const Dcd &dcd);
  void ProcessUcd (const Ucd &ucd);

  // parameters defined in Table 342
  Time m_lostDlMapInterval; 
  Time m_lostUlMapInterval; 
  Time m_maxDcdInterval; 
  Time m_maxUcdInterval; 
  Time m_intervalT1; 
  Time m_intervalT2; 
  Time m_intervalT3; 
  Time m_intervalT7; 
  Time m_intervalT12; 
  Time m_intervalT20; 
  Time m_intervalT21; 
  uint8_t m_maxContentionRangingRetries; 

  // parameters obtained from DL-MAP
  uint8_t m_dcdCount; 
  Mac48Address m_baseStationId; 

  // parameters obtained from UL-MAP
  uint8_t m_ucdCount; 
  double m_allocationStartTime; 

  // to keep the number of DL-MAP/UL-MAP IEs found in the last DL-MAP/U-MAP messages
  uint16_t m_nrDlMapElements; 
  uint16_t m_nrUlMapElements; 

  Ptr<WimaxConnection> m_basicConnection; 
  Ptr<WimaxConnection> m_primaryConnection; 

  EventId m_lostDlMapEvent; 
  EventId m_lostUlMapEvent; 
  EventId m_dcdWaitTimeoutEvent; 
  EventId m_ucdWaitTimeoutEvent; 
  EventId m_rangOppWaitTimeoutEvent; 

  uint32_t m_nrDlMapRecvd; 
  uint32_t m_nrUlMapRecvd; 
  uint32_t m_nrDcdRecvd; 
  uint32_t m_nrUcdRecvd; 

  OfdmDlBurstProfile *m_dlBurstProfile; 
  OfdmUlBurstProfile *m_ulBurstProfile; 

  /*represents the (least robust) modulation type of the SS which it then requests in RNG-REQ and if accepted by BS uses it for receiving and
   transmitting. currently it is set by user in simulation script, shall actually be determined based on SS's distance, power, signal etc*/
  WimaxPhy::ModulationType m_modulationType; 

  bool m_areManagementConnectionsAllocated; 
  bool m_areServiceFlowsAllocated; 

  Ptr<SSScheduler> m_scheduler; 
  Ptr<SsServiceFlowManager> m_serviceFlowManager; 
  Ptr<IpcsClassifier> m_classifier; 

  TracedCallback<Ptr<const Packet>, Mac48Address, const Cid &> m_traceSSRx; 

  TracedCallback<Ptr<const Packet> > m_ssTxTrace;

  TracedCallback<Ptr<const Packet> > m_ssTxDropTrace;

  TracedCallback<Ptr<const Packet> > m_ssPromiscRxTrace;

  TracedCallback<Ptr<const Packet> > m_ssRxTrace;

  TracedCallback<Ptr<const Packet> > m_ssRxDropTrace;

  AsciiTraceCallback m_asciiTxQueueEnqueueCb;
  AsciiTraceCallback m_asciiTxQueueDequeueCb;
  AsciiTraceCallback m_asciiTxQueueDropCb;
};

} // namespace ns3

#endif /* WIMAX_SS_NET_DEVICE_H */