src/devices/wifi/onoe-wifi-manager.h
author Kirill V. Andreev <kirillano@yandex.ru>
Mon, 08 Jun 2009 13:37:30 +0200
changeset 4509 b2654e0f071d
parent 2962 39f72ca0ba8e
child 6065 0f012e7d9128
permissions -rw-r--r--
bug 556: DcfManager does not handle AckTimeout properly when there are multiple queues
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
2271
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
     1
/* -*-  Mode: C++; c-file-style: "gnu"; indent-tabs-mode:nil; -*- */
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
     2
/*
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
     3
 * Copyright (c) 2003,2007 INRIA
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
     4
 *
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
     5
 * This program is free software; you can redistribute it and/or modify
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
     6
 * it under the terms of the GNU General Public License version 2 as 
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
     7
 * published by the Free Software Foundation;
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
     8
 *
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
     9
 * This program is distributed in the hope that it will be useful,
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    10
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    11
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    12
 * GNU General Public License for more details.
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    13
 *
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    14
 * You should have received a copy of the GNU General Public License
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    15
 * along with this program; if not, write to the Free Software
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    16
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    17
 *
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    18
 * Author: Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    19
 */
2544
2e6e1a6e0d94 port last rate control algorithms
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2272
diff changeset
    20
#ifndef ONOE_WIFI_MANAGER_H
2e6e1a6e0d94 port last rate control algorithms
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2272
diff changeset
    21
#define ONOE_WIFI_MANAGER_H
2271
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    22
2544
2e6e1a6e0d94 port last rate control algorithms
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2272
diff changeset
    23
#include "wifi-remote-station-manager.h"
2271
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    24
#include "ns3/nstime.h"
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    25
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    26
namespace ns3 {
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    27
2962
39f72ca0ba8e improve doxygen
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2784
diff changeset
    28
/**
39f72ca0ba8e improve doxygen
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2784
diff changeset
    29
 * \brief an implementation of rate control algorithm developed 
39f72ca0ba8e improve doxygen
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2784
diff changeset
    30
 *        by Atsushi Onoe
39f72ca0ba8e improve doxygen
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2784
diff changeset
    31
 *
39f72ca0ba8e improve doxygen
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2784
diff changeset
    32
 * This algorithm is well known because it has been used as the default
39f72ca0ba8e improve doxygen
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2784
diff changeset
    33
 * rate control algorithm for the madwifi driver. I am not aware of
39f72ca0ba8e improve doxygen
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2784
diff changeset
    34
 * any publication or reference about this algorithm beyond the madwifi
39f72ca0ba8e improve doxygen
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2784
diff changeset
    35
 * source code.
39f72ca0ba8e improve doxygen
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2784
diff changeset
    36
 */
2544
2e6e1a6e0d94 port last rate control algorithms
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2272
diff changeset
    37
class OnoeWifiManager : public WifiRemoteStationManager
2271
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    38
{
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    39
public:
2544
2e6e1a6e0d94 port last rate control algorithms
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2272
diff changeset
    40
  static TypeId GetTypeId (void);
2e6e1a6e0d94 port last rate control algorithms
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2272
diff changeset
    41
2e6e1a6e0d94 port last rate control algorithms
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2272
diff changeset
    42
  OnoeWifiManager ();
2271
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    43
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    44
private:
2544
2e6e1a6e0d94 port last rate control algorithms
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2272
diff changeset
    45
  friend class OnoeWifiRemoteStation;
2e6e1a6e0d94 port last rate control algorithms
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2272
diff changeset
    46
  virtual WifiRemoteStation *CreateStation (void);
2271
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    47
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    48
  Time m_updatePeriod;
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    49
  uint32_t m_addCreditThreshold;
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    50
  uint32_t m_raiseThreshold;
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    51
};
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    52
2544
2e6e1a6e0d94 port last rate control algorithms
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2272
diff changeset
    53
class OnoeWifiRemoteStation : public WifiRemoteStation
2271
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    54
{
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    55
public:
2544
2e6e1a6e0d94 port last rate control algorithms
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2272
diff changeset
    56
  OnoeWifiRemoteStation (Ptr<OnoeWifiManager> stations);
2271
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    57
2544
2e6e1a6e0d94 port last rate control algorithms
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2272
diff changeset
    58
  virtual ~OnoeWifiRemoteStation ();
2271
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    59
2784
49006cbbfac7 GetMaxSsrc -> NeedRtsTransmission and GetMaxSlrc -> NeedDataRetransmission
Federico Maguolo <maguolof@dei.unipd.it>
parents: 2544
diff changeset
    60
protected:
49006cbbfac7 GetMaxSsrc -> NeedRtsTransmission and GetMaxSlrc -> NeedDataRetransmission
Federico Maguolo <maguolof@dei.unipd.it>
parents: 2544
diff changeset
    61
  virtual void DoReportRxOk (double rxSnr, WifiMode txMode);
49006cbbfac7 GetMaxSsrc -> NeedRtsTransmission and GetMaxSlrc -> NeedDataRetransmission
Federico Maguolo <maguolof@dei.unipd.it>
parents: 2544
diff changeset
    62
  virtual void DoReportRtsFailed (void);
49006cbbfac7 GetMaxSsrc -> NeedRtsTransmission and GetMaxSlrc -> NeedDataRetransmission
Federico Maguolo <maguolof@dei.unipd.it>
parents: 2544
diff changeset
    63
  virtual void DoReportDataFailed (void);
49006cbbfac7 GetMaxSsrc -> NeedRtsTransmission and GetMaxSlrc -> NeedDataRetransmission
Federico Maguolo <maguolof@dei.unipd.it>
parents: 2544
diff changeset
    64
  virtual void DoReportRtsOk (double ctsSnr, WifiMode ctsMode, double rtsSnr);
49006cbbfac7 GetMaxSsrc -> NeedRtsTransmission and GetMaxSlrc -> NeedDataRetransmission
Federico Maguolo <maguolof@dei.unipd.it>
parents: 2544
diff changeset
    65
  virtual void DoReportDataOk (double ackSnr, WifiMode ackMode, double dataSnr);
49006cbbfac7 GetMaxSsrc -> NeedRtsTransmission and GetMaxSlrc -> NeedDataRetransmission
Federico Maguolo <maguolof@dei.unipd.it>
parents: 2544
diff changeset
    66
  virtual void DoReportFinalRtsFailed (void);
49006cbbfac7 GetMaxSsrc -> NeedRtsTransmission and GetMaxSlrc -> NeedDataRetransmission
Federico Maguolo <maguolof@dei.unipd.it>
parents: 2544
diff changeset
    67
  virtual void DoReportFinalDataFailed (void);
2271
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    68
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    69
private:
2544
2e6e1a6e0d94 port last rate control algorithms
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2272
diff changeset
    70
  virtual Ptr<WifiRemoteStationManager> GetManager (void) const;
2271
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    71
  virtual WifiMode DoGetDataMode (uint32_t size);
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    72
  virtual WifiMode DoGetRtsMode (void);
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    73
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    74
  void UpdateRetry (void);
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    75
  void UpdateMode (void);
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    76
2544
2e6e1a6e0d94 port last rate control algorithms
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2272
diff changeset
    77
  Ptr<OnoeWifiManager> m_stations;
2272
ae2bbdbfc161 the meat of the onoe rate control algorithm.
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2271
diff changeset
    78
  Time m_nextModeUpdate;
2271
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    79
  uint32_t m_shortRetry;
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    80
  uint32_t m_longRetry;
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    81
  uint32_t m_tx_ok;
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    82
  uint32_t m_tx_err;
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    83
  uint32_t m_tx_retr;
2272
ae2bbdbfc161 the meat of the onoe rate control algorithm.
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2271
diff changeset
    84
  uint32_t m_tx_upper;
ae2bbdbfc161 the meat of the onoe rate control algorithm.
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2271
diff changeset
    85
  uint32_t m_txrate;
2271
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    86
};
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    87
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    88
} // namespace ns3
85724b1cbb1a Onoe rate control
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents:
diff changeset
    89
2544
2e6e1a6e0d94 port last rate control algorithms
Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
parents: 2272
diff changeset
    90
#endif /* ONOE_WIFI_MANAGER_H */