A Discrete-Event Network Simulator
API
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
wifi-mac.h
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2008 INRIA
4  *
5  * This program is free software; you can redistribute it and/or modify
6  * it under the terms of the GNU General Public License version 2 as
7  * published by the Free Software Foundation;
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software
16  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17  *
18  * Author: Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
19  */
20 #ifndef WIFI_MAC_H
21 #define WIFI_MAC_H
22 
23 #include "ns3/packet.h"
24 #include "ns3/mac48-address.h"
25 
26 #include "wifi-phy.h"
28 #include "ssid.h"
29 #include "qos-utils.h"
30 
31 namespace ns3 {
32 
33 class Dcf;
34 
44 class WifiMac : public Object
45 {
46 public:
47  static TypeId GetTypeId (void);
48 
52  virtual void SetSlot (Time slotTime) = 0;
56  virtual void SetSifs (Time sifs) = 0;
63  virtual void SetEifsNoDifs (Time eifsNoDifs) = 0;
67  virtual void SetPifs (Time pifs) = 0;
72  virtual void SetRifs (Time rifs) = 0;
76  virtual void SetCtsTimeout (Time ctsTimeout) = 0;
80  virtual void SetAckTimeout (Time ackTimeout) = 0;
86  void SetMaxPropagationDelay (Time delay);
91  virtual Time GetRifs (void) const = 0;
92 
96  virtual Time GetPifs (void) const = 0;
100  virtual Time GetSifs (void) const = 0;
104  virtual Time GetSlot (void) const = 0;
108  virtual Time GetEifsNoDifs (void) const = 0;
112  virtual Time GetCtsTimeout (void) const = 0;
116  virtual Time GetAckTimeout (void) const = 0;
120  Time GetMsduLifetime (void) const;
124  Time GetMaxPropagationDelay (void) const;
125 
129  virtual Mac48Address GetAddress (void) const = 0;
133  virtual Ssid GetSsid (void) const = 0;
137  virtual void SetAddress (Mac48Address address) = 0;
141  virtual void SetSsid (Ssid ssid) = 0;
145  virtual Mac48Address GetBssid (void) const = 0;
153  virtual void SetPromisc (void) = 0;
154 
166  virtual void Enqueue (Ptr<const Packet> packet, Mac48Address to, Mac48Address from) = 0;
175  virtual void Enqueue (Ptr<const Packet> packet, Mac48Address to) = 0;
176  virtual bool SupportsSendFrom (void) const = 0;
180  virtual void SetWifiPhy (Ptr<WifiPhy> phy) = 0;
184  virtual void SetWifiRemoteStationManager (Ptr<WifiRemoteStationManager> stationManager) = 0;
188  virtual void SetForwardUpCallback (Callback<void,Ptr<Packet>, Mac48Address, Mac48Address> upCallback) = 0;
192  virtual void SetLinkUpCallback (Callback<void> linkUp) = 0;
196  virtual void SetLinkDownCallback (Callback<void> linkDown) = 0;
197  /* Next functions are not pure virtual so non Qos WifiMacs are not
198  * forced to implement them.
199  */
200  virtual void SetBasicBlockAckTimeout (Time blockAckTimeout);
201  virtual Time GetBasicBlockAckTimeout (void) const;
202  virtual void SetCompressedBlockAckTimeout (Time blockAckTimeout);
203  virtual Time GetCompressedBlockAckTimeout (void) const;
204 
209  void NotifyTx (Ptr<const Packet> packet);
210 
215  void NotifyTxDrop (Ptr<const Packet> packet);
216 
221  void NotifyRx (Ptr<const Packet> packet);
222 
227  void NotifyPromiscRx (Ptr<const Packet> packet);
228 
233  void NotifyRxDrop (Ptr<const Packet> packet);
237  void ConfigureStandard (enum WifiPhyStandard standard);
238 
239 protected:
240  void ConfigureDcf (Ptr<Dcf> dcf, uint32_t cwmin, uint32_t cwmax, enum AcIndex ac);
241  void ConfigureCCHDcf (Ptr<Dcf> dcf, uint32_t cwmin, uint32_t cwmax, enum AcIndex ac);
242 private:
243  static Time GetDefaultMaxPropagationDelay (void);
244  static Time GetDefaultSlot (void);
245  static Time GetDefaultSifs (void);
246  static Time GetDefaultRifs (void);
247  static Time GetDefaultEifsNoDifs (void);
248  static Time GetDefaultCtsAckDelay (void);
249  static Time GetDefaultCtsAckTimeout (void);
250  static Time GetDefaultBasicBlockAckDelay (void);
251  static Time GetDefaultBasicBlockAckTimeout (void);
262  virtual void FinishConfigureStandard (enum WifiPhyStandard standard) = 0;
263 
265 
266  void Configure80211a (void);
267  void Configure80211b (void);
268  void Configure80211g (void);
269  void Configure80211_10Mhz (void);
270  void Configure80211_5Mhz ();
271  void Configure80211p_CCH (void);
272  void Configure80211p_SCH (void);
273  void Configure80211n_2_4Ghz (void);
274  void Configure80211n_5Ghz (void);
275 
283 
291 
300 
309 
317 
318 };
319 
320 } // namespace ns3
321 
322 #endif /* WIFI_MAC_H */