Mac80211EventHandler.h
上传用户:rrhhcc
上传日期:2015-12-11
资源大小:54129k
文件大小:5k
源码类别:

通讯编程

开发平台:

Visual C++

  1. /* -*- Mode:C++ -*- */
  2. /*
  3.  * Copyright (c) 2007 Regents of the SIGNET lab, University of Padova.
  4.  * All rights reserved.
  5.  *
  6.  * Redistribution and use in source and binary forms, with or without
  7.  * modification, are permitted provided that the following conditions
  8.  * are met:
  9.  * 1. Redistributions of source code must retain the above copyright
  10.  *    notice, this list of conditions and the following disclaimer.
  11.  * 2. Redistributions in binary form must reproduce the above copyright
  12.  *    notice, this list of conditions and the following disclaimer in the
  13.  *    documentation and/or other materials provided with the distribution.
  14.  * 3. Neither the name of the University of Padova (SIGNET lab) nor the 
  15.  *    names of its contributors may be used to endorse or promote products 
  16.  *    derived from this software without specific prior written permission.
  17.  *
  18.  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 
  19.  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 
  20.  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 
  21.  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR 
  22.  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 
  23.  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 
  24.  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 
  25.  * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 
  26.  * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR 
  27.  * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 
  28.  * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  29.  */
  30. #ifndef MAC80211EVENTHANDLER_H
  31. #define MAC80211EVENTHANDLER_H
  32. #include<phymodes.h>
  33. #include<peerstats.h>
  34. //#include<mac-802_11mr.h>
  35. class Mac802_11mr;
  36. class MR_MAC_MIB;
  37. class MR_PHY_MIB;
  38. class PER;
  39. /**
  40.  * @todo this scheme is nice but does not currently allow for distinction
  41.  * between, e.g., FrameReceives and DataFrameReceives. The reason is
  42.  * that in mac-802_11mr.cc a single counter event is triggered for
  43.  * both. Either we trigger distinct counter events (somehow better) or
  44.  * we use kind of a bitmap for identifying several counter events at
  45.  * once (which is more complex).
  46.  * 
  47.  */
  48. typedef enum {
  49. ID_Unknown = 0,
  50. ID_MPDUTxSuccessful, ID_MPDUTxOneRetry, ID_MPDUTxMultipleRetries, 
  51. ID_MPDUTxFailed, ID_RTSFailed, ID_ACKFailed, 
  52. ID_MPDURxSuccessful, ID_FrameReceives, ID_DataFrameReceives, ID_CtrlFrameReceives, ID_MgmtFrameReceives, 
  53. ID_FrameErrors, ID_DataFrameErrors, ID_CtrlFrameErrors, ID_MgmtFrameErrors, 
  54. ID_FrameErrorsNoise, ID_DataFrameErrorsNoise, ID_CtrlFrameErrorsNoise, ID_MgmtFrameErrorsNoise, 
  55. ID_FrameDropSyn, ID_DataFrameDropSyn, ID_CtrlFrameDropSyn, ID_MgmtFrameDropSyn, 
  56. ID_FrameDropTxa, ID_DataFrameDropTxa, ID_CtrlFrameDropTxa, ID_MgmtFrameDropTxa, 
  57. ID_idleSlots, ID_idle2Slots
  58. } CounterId;
  59. /**
  60.  * This class provides an interface for developing plugins which react
  61.  * to MAC events and perform tunings of MAC parameters 
  62.  * 
  63.  */
  64. class Mac80211EventHandler : public TclObject
  65. {
  66.   friend class Mac802_11mr;
  67. public:
  68.   Mac80211EventHandler();
  69.   virtual ~Mac80211EventHandler();
  70.   /** 
  71.    * Entry point for counter events, to be overloaded by
  72.    * derived classes
  73.    *
  74.    * @param id the id of the counter which has just been updated
  75.    * 
  76.    */
  77.   virtual void counterEvent(CounterId id);
  78.   /** 
  79.    * This method is called when the mac is just to occupy the medium for t seconds
  80.    * 
  81.    * @param t 
  82.    */
  83.   virtual void chBusy(double t); 
  84.   virtual void sendDATA(Packet* p);
  85.   void setBasicMode(PhyMode m);
  86.   void setDataMode(PhyMode m);
  87.   
  88.   void setRTSThreshold(u_int32_t value);
  89.   void setShortRetryLimit(u_int32_t value);
  90.   void setLongRetryLimit(u_int32_t value);
  91.   void setCSThreshold(u_int32_t value);
  92.   virtual int command(int argc, const char*const* argv);
  93. protected:
  94.   /** 
  95.    * Called by the MAC each time counters are updated.
  96.    *
  97.    * The purpose of this method is to invoke both
  98.    * this->counterEvent() and perform some routine needed by the base
  99.    * class. This method is not supposed
  100.    * to be overloaded.
  101.    *
  102.    * @param id the id of the counter which has just been updated
  103.    */
  104.   void counterHandle(CounterId id);
  105.   virtual MR_PHY_MIB* getPhyMib();
  106.   virtual MR_MAC_MIB* getMacMib();
  107.   //  MR_MAC_MIB* getOldMacMib();
  108.   virtual PhyMode getBasicMode();
  109.   virtual PhyMode getDataMode();
  110.   virtual PER* getPER();
  111.   virtual PeerStats* getPeerStats(u_int32_t src, u_int32_t dst);
  112.   Mac802_11mr *mac_;
  113.   Mac80211EventHandler* next;
  114.   //  MR_MAC_MIB* old_MAC_MIB;
  115.   
  116. };
  117. #endif  /*  MAC80211EVENTHANDLER_H */