1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
|
/* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
/*
* Copyright (c) 2006, 2009 INRIA
* Copyright (c) 2009 MIRKO BANCHI
*
* 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
*
* Authors: Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
* Mirko Banchi <mk.banchi@gmail.com>
*/
#ifndef STA_WIFI_MAC_H
#define STA_WIFI_MAC_H
#include "regular-wifi-mac.h"
#include "ns3/event-id.h"
#include "ns3/packet.h"
#include "ns3/traced-callback.h"
#include "supported-rates.h"
#include "amsdu-subframe-header.h"
//added+++++++++
#include "ap-info-collection.h"
#define WITH_HYSTERESIS_HANDOVER_TRIGGER 1
namespace ns3 {
class MgtAddBaRequestHeader;
/**
* \ingroup wifi
*
* The Wifi MAC high model for a non-AP STA in a BSS.
*/
class StaWifiMac : public RegularWifiMac
{
public:
static TypeId GetTypeId (void);
StaWifiMac ();
virtual ~StaWifiMac ();
/**
* \param packet the packet to send.
* \param to the address to which the packet should be sent.
*
* The packet should be enqueued in a tx queue, and should be
* dequeued as soon as the channel access function determines that
* access is granted to this MAC.
*/
virtual void Enqueue (Ptr<const Packet> packet, Mac48Address to);
/**
* \param missed the number of beacons which must be missed
* before a new association sequence is started.
*/
void SetMaxMissedBeacons (uint32_t missed);
/**
* \param timeout
*
* If no probe response is received within the specified
* timeout, the station sends a new probe request.
*/
void SetProbeRequestTimeout (Time timeout);
/**
* \param timeout
*
* If no association response is received within the specified
* timeout, the station sends a new association request.
*/
void SetAssocRequestTimeout (Time timeout);
/**
* Start an active association sequence immediately.
*/
void StartActiveAssociation (void);
private:
/**
* The current MAC state of the STA.
*/
enum MacState
{
ASSOCIATED,
WAIT_PROBE_RESP,
WAIT_ASSOC_RESP,
BEACON_MISSED,
REFUSED
};
/**
* Enable or disable active probing.
*
* \param enable enable or disable active probing
*/
void SetActiveProbing (bool enable);
/**
* Return whether active probing is enabled.
*
* \return true if active probing is enabled, false otherwise
*/
bool GetActiveProbing (void) const;
virtual void Receive (Ptr<Packet> packet, const WifiMacHeader *hdr);
/**
* Forward a probe request packet to the DCF. The standard is not clear on the correct
* queue for management frames if QoS is supported. We always use the DCF.
*/
void SendProbeRequest (void);
/**
* Forward an association request packet to the DCF. The standard is not clear on the correct
* queue for management frames if QoS is supported. We always use the DCF.
*/
void SendAssociationRequest (void);
/**
* Try to ensure that we are associated with an AP by taking an appropriate action
* depending on the current association status.
*/
void TryToEnsureAssociated (void);
/**
* This method is called after the association timeout occurred. We switch the state to
* WAIT_ASSOC_RESP and re-send an association request.
*/
void AssocRequestTimeout (void);
/**
* This method is called after the probe request timeout occurred. We switch the state to
* WAIT_PROBE_RESP and re-send a probe request.
*/
void ProbeRequestTimeout (void);
/**
* Return whether we are associated with an AP.
*
* \return true if we are associated with an AP, false otherwise
*/
bool IsAssociated (void) const;
/**
* Return whether we are waiting for an association response from an AP.
*
* \return true if we are waiting for an association response from an AP, false otherwise
*/
bool IsWaitAssocResp (void) const;
/**
* This method is called after we have not received a beacon from the AP
*/
void MissedBeacons (void);
/**
* Restarts the beacon timer.
*
* \param delay the delay before the watchdog fires
*/
void RestartBeaconWatchdog (Time delay);
/**
* Return an instance of SupportedRates that contains all rates that we support
* including HT rates.
*
* \return SupportedRates all rates that we support
*/
SupportedRates GetSupportedRates (void) const;
/**
* Set the current MAC state.
*
* \param value the new state
*/
void SetState (enum MacState value);
/**
* Return the HT capability of the current AP.
*
* \return the HT capability that we support
*/
HtCapabilities GetHtCapabilities (void) const;
/**
* Return the VHT capability of the current AP.
*
* \return the VHT capability that we support
*/
VhtCapabilities GetVhtCapabilities (void) const;
enum MacState m_state;
Time m_probeRequestTimeout;
Time m_assocRequestTimeout;
EventId m_probeRequestEvent;
EventId m_assocRequestEvent;
EventId m_beaconWatchdog;
Time m_beaconWatchdogEnd;
uint32_t m_maxMissedBeacons;
bool m_activeProbing;
TracedCallback<Mac48Address> m_assocLogger;
TracedCallback<Mac48Address> m_deAssocLogger;
//********for selecting AP********
bool m_isSelectingAP;
double m_currentRssi;
int m_packetCounts;
Time m_delayFromProbResp;
ApInfoCollection m_apInfos;
int m_probeRequestCount;
bool m_isEverAssoicated;
void sendBurstOfProbeRequest();
EventId m_probeRequestBurstEvent;
EventId m_initialEvent;
void loadSupportedRatesOfAp(SupportedRates rates, Mac48Address bssid);
void cleanUpPacketsAndAgreementsWithOldAp();
void sendDissassociationRequest();
//******************************
#ifdef WITH_HYSTERESIS_HANDOVER_TRIGGER
//for triggering wifi handover
RssiMeasureInfo m_currentApRrssiMeasures;
RssiMeasureInfoCollection m_candidadteApRssiMeasures;
EventId m_sendAssocReqEvent;
#endif
};
} //namespace ns3
#endif /* STA_WIFI_MAC_H */
|
