channel-access-manager.h

Go to the documentation of this file.

/* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
/*
 * Copyright (c) 2005,2006 INRIA
 *
 * 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: Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
 */

#ifndef CHANNEL_ACCESS_MANAGER_H
#define CHANNEL_ACCESS_MANAGER_H

#include <vector>
#include <algorithm>
#include "ns3/event-id.h"
#include "ns3/nstime.h"

namespace ns3 {

class WifiPhy;
class PhyListener;
class Txop;
class FrameExchangeManager;

class ChannelAccessManager : public Object
{
public:
  ChannelAccessManager ();
  virtual ~ChannelAccessManager ();

  void SetupPhyListener (Ptr<WifiPhy> phy);
  void RemovePhyListener (Ptr<WifiPhy> phy);
  void SetupFrameExchangeManager (Ptr<FrameExchangeManager> feManager);

  void Add (Ptr<Txop> txop);

  bool NeedBackoffUponAccess (Ptr<Txop> txop);

  void RequestAccess (Ptr<Txop> txop);

  Time GetAccessGrantStart (bool ignoreNav = false) const;

  void NotifyRxStartNow (Time duration);
  void NotifyRxEndOkNow (void);
  void NotifyRxEndErrorNow (void);
  void NotifyTxStartNow (Time duration);
  void NotifyMaybeCcaBusyStartNow (Time duration);
  void NotifySwitchingStartNow (Time duration);
  void NotifySleepNow (void);
  void NotifyOffNow (void);
  void NotifyWakeupNow (void);
  void NotifyOnNow (void);
  void NotifyNavResetNow (Time duration);
  void NotifyNavStartNow (Time duration);
  void NotifyAckTimeoutStartNow (Time duration);
  void NotifyAckTimeoutResetNow (void);
  void NotifyCtsTimeoutStartNow (Time duration);
  void NotifyCtsTimeoutResetNow (void);

  bool IsBusy (void) const;


protected:
  void DoDispose (void) override;


private:
  void UpdateBackoff (void);
  Time MostRecent (std::initializer_list<Time> list) const;
  Time GetBackoffStartFor (Ptr<Txop> txop);
  Time GetBackoffEndFor (Ptr<Txop> txop);

  void DoRestartAccessTimeoutIfNeeded (void);

  void AccessTimeout (void);
  void DoGrantDcfAccess (void);

  virtual Time GetSifs (void) const;
  virtual Time GetSlot (void) const;
  virtual Time GetEifsNoDifs (void) const;

  typedef std::vector<Ptr<Txop>> Txops;

  Txops m_txops;                         
  Time m_lastAckTimeoutEnd;              
  Time m_lastCtsTimeoutEnd;              
  Time m_lastNavStart;                   
  Time m_lastNavDuration;                
  Time m_lastRxStart;                    
  Time m_lastRxDuration;                 
  bool m_lastRxReceivedOk;               
  Time m_lastTxStart;                    
  Time m_lastTxDuration;                 
  Time m_lastBusyStart;                  
  Time m_lastBusyDuration;               
  Time m_lastSwitchingStart;             
  Time m_lastSwitchingDuration;          
  bool m_sleeping;                       
  bool m_off;                            
  Time m_eifsNoDifs;                     
  EventId m_accessTimeout;               
  Time m_slot;                           
  Time m_sifs;                           
  PhyListener* m_phyListener;            
  Ptr<WifiPhy> m_phy;                    
  Ptr<FrameExchangeManager> m_feManager; 
};

} //namespace ns3

#endif /* CHANNEL_ACCESS_MANAGER_H */