/* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */

/*

 * Copyright (c) 2005,2006,2007 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>

 */

#include "wifi-remote-station-manager.h"

#include "ns3/simulator.h"

#include "ns3/assert.h"

#include "ns3/log.h"

#include "ns3/tag.h"

#include "ns3/boolean.h"

#include "ns3/double.h"

#include "ns3/uinteger.h"

#include "ns3/wifi-phy.h"

#include "ns3/trace-source-accessor.h"

#include "wifi-mac-header.h"

#include "wifi-mac-trailer.h"

NS_LOG_COMPONENT_DEFINE ("WifiRemoteStationManager");

/***************************************************************

 *           Packet Mode Tagger

 ***************************************************************/

namespace ns3 {

{

public:

  static TypeId GetTypeId (void);

  virtual TypeId GetInstanceTypeId (void) const;

  virtual uint32_t GetSerializedSize (void) const;

  virtual void Serialize (TagBuffer i) const;

  virtual void Deserialize (TagBuffer i);

  virtual void Print (std::ostream &os) const;

private:

};

{

}

{

}

{

}

TypeId

{

    .SetParent<Tag> ()

  return tid;

}

TypeId

{

  return GetTypeId ();

}

uint32_t

{

}

void

{

}

void

{

}

void

{

}

} // namespace ns3

namespace ns3 {

NS_OBJECT_ENSURE_REGISTERED (WifiRemoteStationManager);

TypeId

WifiRemoteStationManager::GetTypeId (void)

{

  static TypeId tid = TypeId ("ns3::WifiRemoteStationManager")

    .SetParent<Object> ()

    .AddAttribute ("IsLowLatency", "If true, we attempt to modelize a so-called low-latency device: a device"

                   " where decisions about tx parameters can be made on a per-packet basis and feedback about the"

                   " transmission of each packet is obtained before sending the next. Otherwise, we modelize a "

                   " high-latency device, that is a device where we cannot update our decision about tx parameters"

                   " after every packet transmission.",

                   BooleanValue (true), // this value is ignored because there is no setter

                   MakeBooleanAccessor (&WifiRemoteStationManager::IsLowLatency),

                   MakeBooleanChecker ())

    .AddAttribute ("MaxSsrc", "The maximum number of retransmission attempts for an RTS. This value"

                   " will not have any effect on some rate control algorithms.",

                   UintegerValue (7),

                   MakeUintegerAccessor (&WifiRemoteStationManager::m_maxSsrc),

                   MakeUintegerChecker<uint32_t> ())

    .AddAttribute ("MaxSlrc", "The maximum number of retransmission attempts for a DATA packet. This value"

                   " will not have any effect on some rate control algorithms.",

                   UintegerValue (7),

                   MakeUintegerAccessor (&WifiRemoteStationManager::m_maxSlrc),

                   MakeUintegerChecker<uint32_t> ())

    .AddAttribute ("RtsCtsThreshold", "If  the size of the data packet + LLC header + MAC header + FCS trailer is bigger than "

                   "this value, we use an RTS/CTS handshake before sending the data, as per IEEE Std. 802.11-2007, Section 9.2.6. "

                   "This value will not have any effect on some rate control algorithms.",

                   UintegerValue (2346),

                   MakeUintegerAccessor (&WifiRemoteStationManager::m_rtsCtsThreshold),

                   MakeUintegerChecker<uint32_t> ())

    .AddAttribute ("FragmentationThreshold", "If the size of the data packet + LLC header + MAC header + FCS trailer is bigger"

                   "than this value, we fragment it such that the size of the fragments are equal or smaller "

                   "than this value, as per IEEE Std. 802.11-2007, Section 9.4. "

                   "This value will not have any effect on some rate control algorithms.",

                   UintegerValue (2346),

                   MakeUintegerAccessor (&WifiRemoteStationManager::DoSetFragmentationThreshold,

                                         &WifiRemoteStationManager::DoGetFragmentationThreshold),

                   MakeUintegerChecker<uint32_t> ())

    .AddAttribute ("NonUnicastMode", "Wifi mode used for non-unicast transmissions.",

                   WifiModeValue (),

                   MakeWifiModeAccessor (&WifiRemoteStationManager::m_nonUnicastMode),

                   MakeWifiModeChecker ())

    .AddTraceSource ("MacTxRtsFailed",

                     "The transmission of a RTS by the MAC layer has failed",

                     MakeTraceSourceAccessor (&WifiRemoteStationManager::m_macTxRtsFailed))

    .AddTraceSource ("MacTxDataFailed",

                     "The transmission of a data packet by the MAC layer has failed",

                     MakeTraceSourceAccessor (&WifiRemoteStationManager::m_macTxDataFailed))

    .AddTraceSource ("MacTxFinalRtsFailed",

                     "The transmission of a RTS has exceeded the maximum number of attempts",

                     MakeTraceSourceAccessor (&WifiRemoteStationManager::m_macTxFinalRtsFailed))

    .AddTraceSource ("MacTxFinalDataFailed",

                     "The transmission of a data packet has exceeded the maximum number of attempts",

                     MakeTraceSourceAccessor (&WifiRemoteStationManager::m_macTxFinalDataFailed))

  ;

  return tid;

}

WifiRemoteStationManager::WifiRemoteStationManager ()

{

}

WifiRemoteStationManager::~WifiRemoteStationManager ()

{

}

void

WifiRemoteStationManager::DoDispose (void)

{

  for (StationStates::const_iterator i = m_states.begin (); i != m_states.end (); i++)

    {

      delete (*i);

    }

  m_states.clear ();

  for (Stations::const_iterator i = m_stations.begin (); i != m_stations.end (); i++)

    {

      delete (*i);

    }

  m_stations.clear ();

}

void

WifiRemoteStationManager::SetupPhy (Ptr<WifiPhy> phy)

{

  // We need to track our PHY because it is the object that knows the

  // full set of transmit rates that are supported. We need to know

  // this in order to find the relevant mandatory rates when chosing a

  // transmit rate for automatic control responses like

  // acknowledgements.

  m_wifiPhy = phy;

  m_defaultTxMode = phy->GetMode (0);

  Reset ();

}

uint32_t

WifiRemoteStationManager::GetMaxSsrc (void) const

{

  return m_maxSsrc;

}

uint32_t

WifiRemoteStationManager::GetMaxSlrc (void) const

{

  return m_maxSlrc;

}

uint32_t

WifiRemoteStationManager::GetRtsCtsThreshold (void) const

{

  return m_rtsCtsThreshold;

}

uint32_t

WifiRemoteStationManager::GetFragmentationThreshold (void) const

{

  return DoGetFragmentationThreshold ();

}

void

WifiRemoteStationManager::SetMaxSsrc (uint32_t maxSsrc)

{

  m_maxSsrc = maxSsrc;

}

void

WifiRemoteStationManager::SetMaxSlrc (uint32_t maxSlrc)

{

  m_maxSlrc = maxSlrc;

}

void

WifiRemoteStationManager::SetRtsCtsThreshold (uint32_t threshold)

{

  m_rtsCtsThreshold = threshold;

}

void

WifiRemoteStationManager::SetFragmentationThreshold (uint32_t threshold)

{

  DoSetFragmentationThreshold (threshold);

}

void

WifiRemoteStationManager::Reset (Mac48Address address)

{

  NS_ASSERT (!address.IsGroup ());

  WifiRemoteStationState *state = LookupState (address);

  state->m_operationalRateSet.clear ();

  AddSupportedMode (address, GetDefaultMode ());

}

void

WifiRemoteStationManager::AddSupportedMode (Mac48Address address, WifiMode mode)

{

  NS_ASSERT (!address.IsGroup ());

  WifiRemoteStationState *state = LookupState (address);

  for (WifiModeListIterator i = state->m_operationalRateSet.begin (); i != state->m_operationalRateSet.end (); i++)

    {

      if ((*i) == mode)

        {

          // already in.

          return;

        }

    }

  state->m_operationalRateSet.push_back (mode);

}

bool

WifiRemoteStationManager::IsBrandNew (Mac48Address address) const

{

  if (address.IsGroup ())

    {

      return false;

    }

  return LookupState (address)->m_state == WifiRemoteStationState::BRAND_NEW;

}

bool

WifiRemoteStationManager::IsAssociated (Mac48Address address) const

{

  if (address.IsGroup ())

    {

      return true;

    }

  return LookupState (address)->m_state == WifiRemoteStationState::GOT_ASSOC_TX_OK;

}

bool

WifiRemoteStationManager::IsWaitAssocTxOk (Mac48Address address) const

{

  if (address.IsGroup ())

    {

      return false;

    }

  return LookupState (address)->m_state == WifiRemoteStationState::WAIT_ASSOC_TX_OK;