00001
00002
00003
00004
00005
00006
00007
00008
00009
00010
00011
00012
00013
00014
00015
00016
00017
00018
00019
00020 #ifndef MAC_LOW_H
00021 #define MAC_LOW_H
00022
00023 #include <vector>
00024 #include <stdint.h>
00025 #include <ostream>
00026
00027 #include "wifi-mac-header.h"
00028 #include "wifi-mode.h"
00029 #include "wifi-preamble.h"
00030 #include "wifi-remote-station-manager.h"
00031 #include "ns3/mac48-address.h"
00032 #include "ns3/callback.h"
00033 #include "ns3/event-id.h"
00034 #include "ns3/packet.h"
00035 #include "ns3/nstime.h"
00036
00037 namespace ns3 {
00038
00039 class WifiPhy;
00040 class WifiMac;
00041
00042
00043
00044
00045 class MacLowTransmissionListener {
00046 public:
00047 MacLowTransmissionListener ();
00048 virtual ~MacLowTransmissionListener ();
00049
00050
00051
00052
00053
00054
00055
00056
00057 virtual void GotCts (double snr, WifiMode txMode) = 0;
00058
00059
00060
00061
00062 virtual void MissedCts (void) = 0;
00063
00064
00065
00066
00067
00068
00069
00070
00071
00072 virtual void GotAck (double snr, WifiMode txMode) = 0;
00073
00074
00075
00076
00077 virtual void MissedAck (void) = 0;
00078
00079
00080
00081
00082
00083
00084 virtual void StartNext (void) = 0;
00085
00086
00087
00088
00089
00090
00091
00092 virtual void Cancel (void) = 0;
00093 };
00094
00095
00096
00097
00098
00099
00100
00101
00102
00103 class MacLowNavListener {
00104 public:
00105 MacLowNavListener ();
00106 virtual ~MacLowNavListener ();
00107
00108
00109
00110 virtual void NavStart (Time duration) = 0;
00111
00112
00113
00114 virtual void NavReset (Time duration) = 0;
00115 };
00116
00117
00118
00119
00120
00121
00122
00123
00124 class MacLowTransmissionParameters {
00125 public:
00126 MacLowTransmissionParameters ();
00127
00128
00129
00130
00131
00132
00133 void EnableAck (void);
00134
00135
00136
00137
00138
00139
00140
00141
00142
00143
00144
00145
00146
00147 void EnableFastAck (void);
00148
00149
00150
00151
00152
00153
00154 void EnableSuperFastAck (void);
00155
00156
00157
00158
00159
00160
00161 void EnableRts (void);
00162
00163
00164
00165
00166
00167
00168
00169
00170
00171 void EnableNextData (uint32_t size);
00172
00173
00174
00175
00176
00177
00178
00179
00180 void EnableOverrideDurationId (Time durationId);
00181
00182
00183
00184
00185
00186 void DisableAck (void);
00187
00188
00189
00190 void DisableRts (void);
00191
00192
00193
00194 void DisableNextData (void);
00195
00196
00197
00198
00199
00200 void DisableOverrideDurationId (void);
00201
00202
00203
00204
00205
00206
00207
00208
00209 bool MustWaitAck (void) const;
00210
00211
00212
00213
00214
00215
00216 bool MustWaitNormalAck (void) const;
00217
00218
00219
00220
00221
00222
00223 bool MustWaitFastAck (void) const;
00224
00225
00226
00227
00228
00229
00230 bool MustWaitSuperFastAck (void) const;
00231
00232
00233
00234
00235 bool MustSendRts (void) const;
00236
00237
00238
00239
00240 bool HasDurationId (void) const;
00241
00242
00243
00244 Time GetDurationId (void) const;
00245
00246
00247
00248 bool HasNextPacket (void) const;
00249
00250
00251
00252 uint32_t GetNextPacketSize (void) const;
00253
00254 private:
00255 friend std::ostream &operator << (std::ostream &os, const MacLowTransmissionParameters ¶ms);
00256 uint32_t m_nextSize;
00257 enum {
00258 ACK_NONE,
00259 ACK_NORMAL,
00260 ACK_FAST,
00261 ACK_SUPER_FAST
00262 } m_waitAck;
00263 bool m_sendRts;
00264 Time m_overrideDurationId;
00265 };
00266
00267 std::ostream &operator << (std::ostream &os, const MacLowTransmissionParameters ¶ms);
00268
00269
00270
00271
00272
00273 class MacLow : public Object {
00274 public:
00275 typedef Callback<void, Ptr<Packet> , WifiMacHeader const*> MacLowRxCallback;
00276
00277 MacLow ();
00278 virtual ~MacLow ();
00279
00280 void SetPhy (Ptr<WifiPhy> phy);
00281 void SetWifiRemoteStationManager (Ptr<WifiRemoteStationManager> manager);
00282
00283 void SetAddress (Mac48Address ad);
00284 void SetAckTimeout (Time ackTimeout);
00285 void SetCtsTimeout (Time ctsTimeout);
00286 void SetSifs (Time sifs);
00287 void SetSlotTime (Time slotTime);
00288 void SetPifs (Time pifs);
00289 void SetBssid (Mac48Address ad);
00290 Mac48Address GetAddress (void) const;
00291 Time GetAckTimeout (void) const;
00292 Time GetCtsTimeout (void) const;
00293 Time GetSifs (void) const;
00294 Time GetSlotTime (void) const;
00295 Time GetPifs (void) const;
00296 Mac48Address GetBssid (void) const;
00297
00298
00299
00300
00301
00302
00303
00304 void SetRxCallback (Callback<void,Ptr<Packet>,const WifiMacHeader *> callback);
00305
00306
00307
00308
00309 void RegisterNavListener (MacLowNavListener *listener);
00310
00311
00312
00313
00314
00315
00316
00317
00318
00319 Time CalculateTransmissionTime (Ptr<const Packet> packet,
00320 WifiMacHeader const*hdr,
00321 MacLowTransmissionParameters const¶meters) const;
00322
00323
00324
00325
00326
00327
00328
00329
00330
00331
00332 void StartTransmission (Ptr<const Packet> packet,
00333 WifiMacHeader const*hdr,
00334 MacLowTransmissionParameters parameters,
00335 MacLowTransmissionListener *listener);
00336
00337
00338
00339
00340
00341
00342
00343 void ReceiveOk (Ptr<Packet> packet);
00344
00345
00346
00347
00348
00349
00350 void ReceiveError (Ptr<const Packet> packet);
00351 private:
00352 void CancelAllEvents (void);
00353 uint32_t GetAckSize (void) const;
00354 uint32_t GetRtsSize (void) const;
00355 uint32_t GetCtsSize (void) const;
00356 uint32_t GetSize (Ptr<const Packet> packet, const WifiMacHeader *hdr) const;
00357 Time NowUs (void) const;
00358 WifiRemoteStation *GetStation (Mac48Address to) const;
00359 void ForwardDown (Ptr<const Packet> packet, WifiMacHeader const *hdr,
00360 WifiMode txMode);
00361 Time CalculateOverallTxTime (Ptr<const Packet> packet,
00362 WifiMacHeader const*hdr,
00363 MacLowTransmissionParameters const ¶ms) const;
00364 WifiMode GetRtsTxMode (Ptr<const Packet> packet, const WifiMacHeader *hdr) const;
00365 WifiMode GetDataTxMode (Ptr<const Packet> packet, const WifiMacHeader *hdr) const;
00366 WifiMode GetCtsTxModeForRts (Mac48Address to, WifiMode rtsTxMode) const;
00367 WifiMode GetAckTxModeForData (Mac48Address to, WifiMode dataTxMode) const;
00368 Time GetCtsDuration (Mac48Address to, WifiMode rtsTxMode) const;
00369 Time GetAckDuration (Mac48Address to, WifiMode dataTxMode) const;
00370 void NotifyNav (const WifiMacHeader &hdr, WifiMode txMode, WifiPreamble preamble);
00371 void DoNavResetNow (Time duration);
00372 bool DoNavStartNow (Time duration);
00373 bool IsNavZero (void) const;
00374 void MaybeCancelPrevious (void);
00375
00376 void NavCounterResetCtsMissed (Time rtsEndRxTime);
00377 void NormalAckTimeout (void);
00378 void FastAckTimeout (void);
00379 void SuperFastAckTimeout (void);
00380 void FastAckFailedTimeout (void);
00381 void CtsTimeout (void);
00382 void SendCtsAfterRts (Mac48Address source, Time duration, WifiMode txMode, double rtsSnr);
00383 void SendAckAfterData (Mac48Address source, Time duration, WifiMode txMode, double rtsSnr);
00384 void SendDataAfterCts (Mac48Address source, Time duration, WifiMode txMode);
00385 void WaitSifsAfterEndTx (void);
00386
00387 void SendRtsForPacket (void);
00388 void SendDataPacket (void);
00389 void SendCurrentTxPacket (void);
00390 void StartDataTxTimers (void);
00391 virtual void DoDispose (void);
00392
00393 Ptr<WifiPhy> m_phy;
00394 Ptr<WifiRemoteStationManager> m_stationManager;
00395 MacLowRxCallback m_rxCallback;
00396 typedef std::vector<MacLowNavListener *>::const_iterator NavListenersCI;
00397 typedef std::vector<MacLowNavListener *> NavListeners;
00398 NavListeners m_navListeners;
00399
00400 EventId m_normalAckTimeoutEvent;
00401 EventId m_fastAckTimeoutEvent;
00402 EventId m_superFastAckTimeoutEvent;
00403 EventId m_fastAckFailedTimeoutEvent;
00404 EventId m_ctsTimeoutEvent;
00405 EventId m_sendCtsEvent;
00406 EventId m_sendAckEvent;
00407 EventId m_sendDataEvent;
00408 EventId m_waitSifsEvent;
00409 EventId m_navCounterResetCtsMissed;
00410
00411 Ptr<Packet> m_currentPacket;
00412 WifiMacHeader m_currentHdr;
00413 MacLowTransmissionParameters m_txParams;
00414 MacLowTransmissionListener *m_listener;
00415 Mac48Address m_self;
00416 Mac48Address m_bssid;
00417 Time m_ackTimeout;
00418 Time m_ctsTimeout;
00419 Time m_sifs;
00420 Time m_slotTime;
00421 Time m_pifs;
00422
00423 Time m_lastNavStart;
00424 Time m_lastNavDuration;
00425 };
00426
00427 }
00428
00429 #endif