add WifiMacQueue to build
authorMathieu Lacage <mathieu.lacage@sophia.inria.fr>
Tue, 09 Oct 2007 12:20:43 +0200
changeset 1924 0471fb5a3df8
parent 1923 a8caecf6637f
child 1925 12faa084fe5b
add WifiMacQueue to build
src/devices/wifi/wifi-mac-queue.cc
src/devices/wifi/wifi-mac-queue.h
src/devices/wifi/wscript
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/src/devices/wifi/wifi-mac-queue.cc	Tue Oct 09 12:20:43 2007 +0200
@@ -0,0 +1,130 @@
+/* -*-  Mode: C++; c-file-style: "gnu"; indent-tabs-mode:nil; -*- */
+/*
+ * Copyright (c) 2005 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 "ns3/simulator.h"
+#include "ns3/packet.h"
+
+#include "wifi-mac-queue.h"
+
+using namespace std;
+
+namespace ns3 {
+
+WifiMacQueue::Item::Item (Packet packet, 
+                            WifiMacHeader const &hdr, 
+                            Time tstamp)
+  : packet (packet), hdr (hdr), tstamp (tstamp)
+{}
+
+WifiMacQueue::WifiMacQueue ()
+  : m_size (0)
+{}
+
+WifiMacQueue::~WifiMacQueue ()
+{
+  Flush ();
+}
+
+void 
+WifiMacQueue::SetMaxSize (uint32_t maxSize)
+{
+  m_maxSize = maxSize;
+}
+void 
+WifiMacQueue::SetMaxDelay (Time delay)
+{
+  m_maxDelay = delay;
+}
+void 
+WifiMacQueue::Enqueue (Packet packet, WifiMacHeader const &hdr)
+{
+  Cleanup ();
+  if (m_size == m_maxSize) 
+    {
+      return;
+    }
+  Time now = Simulator::Now ();
+  m_queue.push_back (Item (packet, hdr, now));
+  m_size++;
+}
+void
+WifiMacQueue::Cleanup (void)
+{
+  if (m_queue.empty ()) 
+    {
+      return;
+    }
+
+  Time now = Simulator::Now ();
+  uint32_t n = 0;
+  PacketQueueI end = m_queue.begin ();
+  for (PacketQueueI i = m_queue.begin (); i != m_queue.end (); i++) 
+    {
+      if (i->tstamp + m_maxDelay > now) 
+        {
+          end = i;
+          break;
+        }
+      n++;
+    }
+  m_size -= n;
+  m_queue.erase (m_queue.begin (), end);
+}
+
+Packet 
+WifiMacQueue::Dequeue (WifiMacHeader *hdr, bool *found)
+{
+  Cleanup ();
+  if (!m_queue.empty ()) 
+    {
+      Item i = m_queue.front ();
+      m_queue.pop_front ();
+      m_size--;
+      *hdr = i.hdr;
+      *found = true;
+      return i.packet;
+    }
+  *found = false;
+  return Packet ();
+}
+
+
+bool
+WifiMacQueue::IsEmpty (void)
+{
+  Cleanup ();
+  return m_queue.empty ();
+}
+
+
+uint32_t
+WifiMacQueue::GetSize (void)
+{
+  return m_size;
+}
+
+void
+WifiMacQueue::Flush (void)
+{
+  m_queue.erase (m_queue.begin (), m_queue.end ());
+  m_size = 0;
+}
+
+}; // namespace ns3
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/src/devices/wifi/wifi-mac-queue.h	Tue Oct 09 12:20:43 2007 +0200
@@ -0,0 +1,92 @@
+/* -*-  Mode: C++; c-file-style: "gnu"; indent-tabs-mode:nil; -*- */
+/*
+ * Copyright (c) 2005 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 WIFI_MAC_QUEUE_H
+#define WIFI_MAC_QUEUE_H
+
+/* This queue implements what is needed for the 802.11e standard
+ * Specifically, it refers to 802.11e/D9, section 9.9.1.6, paragraph 6.
+ *
+ * When a packet is received by the MAC, to be sent to the PHY, 
+ * it is queued in the internal queue after being tagged by the 
+ * current time. If the queue is non-Empty (quite likely), we
+ * notify m_packetNotify. This information is forwarded to 
+ * The associated MacLow80211 which might try to dequeue packets
+ * from this queue if it is not doing anything else more important.
+ *
+ * If it is doing something too important to handle new packets,
+ * the MacLow80211 is supposed to try to dequeue packets the next 
+ * time it can.
+ *
+ * When a packet is dequeued, the queue checks its timestamp 
+ * to verify whether or not it should be dropped. If 
+ * dot11EDCATableMSDULifetime has elapsed, it is dropped.
+ * Otherwise, it is returned to the caller.
+ */
+
+#include <deque>
+#include <utility>
+#include "ns3/packet.h"
+#include "ns3/nstime.h"
+#include "wifi-mac-header.h"
+
+namespace ns3 {
+
+class MacParameters;
+
+class WifiMacQueue {
+public:
+  WifiMacQueue ();
+  ~WifiMacQueue ();
+
+  void SetMaxSize (uint32_t maxSize);
+  void SetMaxDelay (Time delay);
+
+  void Enqueue (Packet packet, WifiMacHeader const &hdr);
+  Packet Dequeue (WifiMacHeader *hdr, bool *found);
+
+  void Flush (void);
+
+  bool IsEmpty (void);
+  uint32_t GetSize (void);
+
+private:
+  void Cleanup (void);
+  struct Item {
+    Item (Packet packet, 
+          WifiMacHeader const&hdr, 
+          Time tstamp);
+    Packet packet;
+    WifiMacHeader hdr;
+    Time tstamp;
+  };
+  typedef std::deque<struct Item> PacketQueue;
+  typedef std::deque<struct Item>::reverse_iterator PacketQueueRI;
+  typedef std::deque<struct Item>::iterator PacketQueueI;
+  PacketQueue m_queue;
+  MacParameters *m_parameters;
+  uint32_t m_size;
+  uint32_t m_maxSize;
+  Time m_maxDelay;
+};
+
+} // namespace ns3
+
+
+#endif /* WIFI_MAC_QUEUE_H */
--- a/src/devices/wifi/wscript	Tue Oct 09 12:17:02 2007 +0200
+++ b/src/devices/wifi/wscript	Tue Oct 09 12:20:43 2007 +0200
@@ -18,6 +18,7 @@
         'mac-parameters.cc',
         'mac-low.cc',
         'dcf.cc',
+        'wifi-mac-queue.cc'
         ]
     headers = bld.create_obj('ns3header')
     headers.source = [