Attachment #1727 for bug #938

View | Details | Raw Unified | Return to bug 938
Collapse All | Expand All

(-)a/src/wifi/model/aarf-wifi-manager.cc (+8 lines)

Lines 31-36	Link Here

namespace ns3 {

namespace ns3 {

/**

 * \brief hold per-remote-station state for AARF Wifi manager.

 * This struct extends from WifiRemoteStation struct to hold additional

 * information required by the AARF Wifi manager

*/

struct AarfWifiRemoteStation : public WifiRemoteStation

struct AarfWifiRemoteStation : public WifiRemoteStation

  uint32_t m_timer;

  uint32_t m_timer;

Lines 123-128	Link Here

123

 * is the initial transmission of a packet or the retransmission of a packet.

129

 * is the initial transmission of a packet or the retransmission of a packet.

124

 * The fundamental reason for this is that there is a backoff between each data

130

 * The fundamental reason for this is that there is a backoff between each data

125

 * transmission, be it an initial transmission or a retransmission.

131

 * transmission, be it an initial transmission or a retransmission.

132

133

 * \param st the station that we failed to send DATA

126

*/

134

*/

127

void

135

void

128

AarfWifiManager::DoReportDataFailed (WifiRemoteStation *st)

136

AarfWifiManager::DoReportDataFailed (WifiRemoteStation *st)





namespace ns3 {

/**
 * \brief hold per-remote-station state for AARF-CD Wifi manager.
 *
 * This struct extends from WifiRemoteStation struct to hold additional
 * information required by the AARF-CD Wifi manager
 */
struct AarfcdWifiRemoteStation : public WifiRemoteStation
{
  uint32_t m_timer;

{
  NS_LOG_FUNCTION (this << station);
}

 * It is important to realize that "recovery" mode starts after failure of
 * the first transmission after a rate increase and ends at the first successful
 * transmission. Specifically, recovery mode transcends retransmissions boundaries.
 * Fundamentally, ARF handles each data transmission independently, whether it
 * is the initial transmission of a packet or the retransmission of a packet.
 * The fundamental reason for this is that there is a backoff between each data
 * transmission, be it an initial transmission or a retransmission.
 */
void
AarfcdWifiManager::DoReportDataFailed (WifiRemoteStation *st)
{

(-)a/src/wifi/model/aarfcd-wifi-manager.h (+37 lines)

Lines 47-53	Link Here

  virtual WifiRemoteStation * DoCreateStation (void) const;

  virtual WifiRemoteStation * DoCreateStation (void) const;

  virtual void DoReportRxOk (WifiRemoteStation *station,

  virtual void DoReportRxOk (WifiRemoteStation *station,

                             double rxSnr, WifiMode txMode);

                             double rxSnr, WifiMode txMode);

  virtual void DoReportRtsFailed (WifiRemoteStation *station);

  virtual void DoReportRtsFailed (WifiRemoteStation *station);

/**

   * It is important to realize that "recovery" mode starts after failure of

   * the first transmission after a rate increase and ends at the first successful

   * transmission. Specifically, recovery mode transcends retransmissions boundaries.

   * Fundamentally, ARF handles each data transmission independently, whether it

   * is the initial transmission of a packet or the retransmission of a packet.

   * The fundamental reason for this is that there is a backoff between each data

   * transmission, be it an initial transmission or a retransmission.

   * \param station the station that we failed to send DATA

*/

  virtual void DoReportDataFailed (WifiRemoteStation *station);

  virtual void DoReportDataFailed (WifiRemoteStation *station);

  virtual void DoReportRtsOk (WifiRemoteStation *station,

  virtual void DoReportRtsOk (WifiRemoteStation *station,

                              double ctsSnr, WifiMode ctsMode, double rtsSnr);

                              double ctsSnr, WifiMode ctsMode, double rtsSnr);

Lines 61-70	Link Here

                          Ptr<const Packet> packet, bool normally);

                          Ptr<const Packet> packet, bool normally);

  virtual bool IsLowLatency (void) const;

  virtual bool IsLowLatency (void) const;

/**

   * Check if the use of RTS for the given station can be turned off.

   * \param station the station that we are checking

*/

  void CheckRts (AarfcdWifiRemoteStation *station);

  void CheckRts (AarfcdWifiRemoteStation *station);

/**

   * Increase the RTS window size of the given station.

   * \param station the station to increase RTS window

*/

  void IncreaseRtsWnd (AarfcdWifiRemoteStation *station);

  void IncreaseRtsWnd (AarfcdWifiRemoteStation *station);

/**

   * Reset the RTS window of the given station.

   * \param station the station to reset RTS window

*/

  void ResetRtsWnd (AarfcdWifiRemoteStation *station);

  void ResetRtsWnd (AarfcdWifiRemoteStation *station);

/**

   * Turn off RTS for the given station.

   * \param station the station to turn RTS off

*/

  void TurnOffRts (AarfcdWifiRemoteStation *station);

  void TurnOffRts (AarfcdWifiRemoteStation *station);

100

/**

101

   * Turn on RTS for the given station.

102

103

   * \param station the station to turn RTS on

104

*/

  void TurnOnRts (AarfcdWifiRemoteStation *station);

105

  void TurnOnRts (AarfcdWifiRemoteStation *station);

106

  // aarf fields below

107

  // aarf fields below

(-)a/src/wifi/model/amrr-wifi-manager.cc (+6 lines)

Lines 30-35	Link Here

namespace ns3 {

namespace ns3 {

/**

 * \brief hold per-remote-station state for AMRR Wifi manager.

 * This struct extends from WifiRemoteStation struct to hold additional

 * information required by the AMRR Wifi manager

*/

struct AmrrWifiRemoteStation : public WifiRemoteStation

struct AmrrWifiRemoteStation : public WifiRemoteStation

  Time m_nextModeUpdate;

  Time m_nextModeUpdate;

(-)a/src/wifi/model/arf-wifi-manager.cc (+8 lines)

Lines 30-35	Link Here

namespace ns3 {

namespace ns3 {

/**

 * \brief hold per-remote-station state for ARF Wifi manager.

 * This struct extends from WifiRemoteStation struct to hold additional

 * information required by the ARF Wifi manager

*/

struct ArfWifiRemoteStation : public WifiRemoteStation

struct ArfWifiRemoteStation : public WifiRemoteStation

  uint32_t m_timer;

  uint32_t m_timer;

Lines 105-110	Link Here

105

 * is the initial transmission of a packet or the retransmission of a packet.

111

 * is the initial transmission of a packet or the retransmission of a packet.

106

 * The fundamental reason for this is that there is a backoff between each data

112

 * The fundamental reason for this is that there is a backoff between each data

107

 * transmission, be it an initial transmission or a retransmission.

113

 * transmission, be it an initial transmission or a retransmission.

114

115

 * \param st the station that we failed to send DATA

108

*/

116

*/

109

void

117

void

110

ArfWifiManager::DoReportDataFailed (WifiRemoteStation *st)

118

ArfWifiManager::DoReportDataFailed (WifiRemoteStation *st)

(-)a/src/wifi/model/block-ack-agreement.h (+74 lines)

Lines 33-54	Link Here

  friend class MacLow;

  friend class MacLow;

public:

public:

  BlockAckAgreement ();

  BlockAckAgreement ();

/**

   * Constructor for BlockAckAgreement with given peer and TID.

   * \param peer

   * \param tid

*/

  BlockAckAgreement (Mac48Address peer, uint8_t tid);

  BlockAckAgreement (Mac48Address peer, uint8_t tid);

  ~BlockAckAgreement ();

  ~BlockAckAgreement ();

/**

   * Set buffer size.

   * \param bufferSize

*/

  void SetBufferSize (uint16_t bufferSize);

  void SetBufferSize (uint16_t bufferSize);

/**

   * Set timeout.

   * \param timeout

*/

  void SetTimeout (uint16_t timeout);

  void SetTimeout (uint16_t timeout);

/**

   * Set starting sequence number.

   * \param seq the starting sequence number

*/

  void SetStartingSequence (uint16_t seq);

  void SetStartingSequence (uint16_t seq);

/**

   * Set Block ACK policy to immediate ACK.

*/

  void SetImmediateBlockAck (void);

  void SetImmediateBlockAck (void);

/**

   * Set Block ACK policy to delayed ACK.

*/

  void SetDelayedBlockAck (void);

  void SetDelayedBlockAck (void);

/**

   * Enable or disable A-MSDU support.

   * \param supported enable or disable A-MSDU support

*/

  void SetAmsduSupport (bool supported);

  void SetAmsduSupport (bool supported);

/**

   * Return the Traffic ID (TID).

   * \return TID

*/

  uint8_t GetTid (void) const;

  uint8_t GetTid (void) const;

/**

   * Return the peer address.

   * \return Mac48Address

*/

  Mac48Address GetPeer (void) const;

  Mac48Address GetPeer (void) const;

/**

   * Return the buffer size.

   * \return buffer size

*/

  uint16_t GetBufferSize (void) const;

  uint16_t GetBufferSize (void) const;

/**

   * Return the timeout.

   * \return timeout

*/

  uint16_t GetTimeout (void) const;

100

  uint16_t GetTimeout (void) const;

101

/**

102

   * Return the starting squence number.

103

104

   * \return starting sequence number

105

*/

  uint16_t GetStartingSequence (void) const;

106

  uint16_t GetStartingSequence (void) const;

107

/**

108

   * Return the starting squence control

109

110

   * \return starting sequence control

111

*/

  uint16_t GetStartingSequenceControl (void) const;

112

  uint16_t GetStartingSequenceControl (void) const;

113

/**

114

   * Check whether the current ACK policy is immediate block ACK.

115

116

   * \return true if the current ACK policy is immediate block ACK,

117

   *         false otherwise

118

*/

  bool IsImmediateBlockAck (void) const;

119

  bool IsImmediateBlockAck (void) const;

120

/**

121

   * Check whether A-MSDU is supported

122

123

   * \return true if A-MSDU is supported,

124

   *         false otherwise

125

*/

  bool IsAmsduSupported (void) const;

126

  bool IsAmsduSupported (void) const;

127

protected:

128

protected:

(-)a/src/wifi/model/block-ack-manager.h (-1 / +58 lines)

Lines 47-52	Link Here

struct Bar

struct Bar

  Bar ();

  Bar ();

/**

   * Construct Block ACK request for a given packet,

   * receiver address, Traffic ID, and ACK policy.

   * \param packet

   * \param recipient

   * \param tid

   * \param immediate

*/

  Bar (Ptr<const Packet> packet,

  Bar (Ptr<const Packet> packet,

       Mac48Address recipient,

       Mac48Address recipient,

       uint8_t tid,

       uint8_t tid,

Lines 73-78	Link Here

/**

/**

   * \param recipient Address of peer station involved in block ack mechanism.

   * \param recipient Address of peer station involved in block ack mechanism.

   * \param tid Traffic ID.

   * \param tid Traffic ID.

   * \return true  if a block ack agreement exists, false otherwise

   * Checks if a block ack agreement exists with station addressed by

   * Checks if a block ack agreement exists with station addressed by

   * <i>recipient</i> for tid <i>tid</i>.

   * <i>recipient</i> for tid <i>tid</i>.

Lines 82-88	Link Here

   * \param recipient Address of peer station involved in block ack mechanism.

   * \param recipient Address of peer station involved in block ack mechanism.

   * \param tid Traffic ID.

   * \param tid Traffic ID.

   * \param state The state for block ack agreement

   * \param state The state for block ack agreement

   * \return true if a block ack agreement exists, false otherwise

   * Checks if a block ack agreement with a state equals to <i>state</i> exists with

   * Checks if a block ack agreement with a state equals to <i>state</i> exists with

   * station addressed by <i>recipient</i> for tid <i>tid</i>.

   * station addressed by <i>recipient</i> for tid <i>tid</i>.

*/

*/

Lines 122-127	Link Here

122

  void StorePacket (Ptr<const Packet> packet, const WifiMacHeader &hdr, Time tStamp);

133

  void StorePacket (Ptr<const Packet> packet, const WifiMacHeader &hdr, Time tStamp);

123

/**

134

/**

124

   * \param hdr 802.11 header of returned packet (if exists).

135

   * \param hdr 802.11 header of returned packet (if exists).

136

   * \return the packet

125

137

126

   * This methods returns a packet (if exists) indicated as not received in

138

   * This methods returns a packet (if exists) indicated as not received in

127

   * corresponding block ack bitmap.

139

   * corresponding block ack bitmap.

Lines 131-136	Link Here

131

/**

143

/**

132

   * Returns true if there are packets that need of retransmission or at least a

144

   * Returns true if there are packets that need of retransmission or at least a

133

   * BAR is scheduled. Returns false otherwise.

145

   * BAR is scheduled. Returns false otherwise.

146

147

   * \return true if there are packets that need of retransmission or at least a

148

   *         BAR is scheduled, false otherwise

134

*/

149

*/

135

  bool HasPackets (void) const;

150

  bool HasPackets (void) const;

136

/**

151

/**

Lines 146-151	Link Here

146

/**

161

/**

147

   * \param recipient Address of peer station involved in block ack mechanism.

162

   * \param recipient Address of peer station involved in block ack mechanism.

148

   * \param tid Traffic ID.

163

   * \param tid Traffic ID.

164

   * \return the number of packets buffered for a specified agreement

149

165

150

   * Returns number of packets buffered for a specified agreement. This methods doesn't return

166

   * Returns number of packets buffered for a specified agreement. This methods doesn't return

151

   * number of buffered MPDUs but number of buffered MSDUs.

167

   * number of buffered MPDUs but number of buffered MSDUs.

Lines 154-159	Link Here

154

/**

170

/**

155

   * \param recipient Address of peer station involved in block ack mechanism.

171

   * \param recipient Address of peer station involved in block ack mechanism.

156

   * \param tid Traffic ID.

172

   * \param tid Traffic ID.

173

   * \return the number of packets for a specific agreement that need retransmission

157

174

158

   * Returns number of packets for a specific agreement that need retransmission.

175

   * Returns number of packets for a specific agreement that need retransmission.

159

   * This method doesn't return number of MPDUs that need retransmission but number of MSDUs.

176

   * This method doesn't return number of MPDUs that need retransmission but number of MSDUs.

Lines 216-227	Link Here

216

/**

233

/**

217

   * \param sequenceNumber Sequence number of the packet which fragment is

234

   * \param sequenceNumber Sequence number of the packet which fragment is

218

   * part of.

235

   * part of.

236

   * \return true if another fragment with the given sequence number is scheduled

237

   * for retransmission.

219

238

220

   * Returns true if another fragment with sequence number <i>sequenceNumber</i> is scheduled

239

   * Returns true if another fragment with sequence number <i>sequenceNumber</i> is scheduled

221

   * for retransmission.

240

   * for retransmission.

222

*/

241

*/

223

  bool HasOtherFragments (uint16_t sequenceNumber) const;

242

  bool HasOtherFragments (uint16_t sequenceNumber) const;

224

/**

243

/**

244

   * \return the size of the next packet that needs retransmission

245

225

   * Returns size of the next packet that needs retransmission.

246

   * Returns size of the next packet that needs retransmission.

226

*/

247

*/

227

  uint32_t GetNextPacketSize (void) const;

248

  uint32_t GetNextPacketSize (void) const;

Lines 238-243	Link Here

238

  void SetBlockDestinationCallback (Callback<void, Mac48Address, uint8_t> callback);

259

  void SetBlockDestinationCallback (Callback<void, Mac48Address, uint8_t> callback);

239

  void SetUnblockDestinationCallback (Callback<void, Mac48Address, uint8_t> callback);

260

  void SetUnblockDestinationCallback (Callback<void, Mac48Address, uint8_t> callback);

240

/**

261

/**

262

   * \param recipient

263

   * \param tid

264

   * \param startingSeq

265

   * \return true if there are packets in the queue that could be sent under block ACK,

266

   *         false otherwise

267

241

   * Checks if there are in the queue other packets that could be send under block ack.

268

   * Checks if there are in the queue other packets that could be send under block ack.

242

   * If yes adds these packets in current block ack exchange.

269

   * If yes adds these packets in current block ack exchange.

243

   * However, number of packets exchanged in the current block ack, will not exceed

270

   * However, number of packets exchanged in the current block ack, will not exceed

Lines 245-250	Link Here

245

*/

272

*/

246

  bool SwitchToBlockAckIfNeeded (Mac48Address recipient, uint8_t tid, uint16_t startingSeq);

273

  bool SwitchToBlockAckIfNeeded (Mac48Address recipient, uint8_t tid, uint16_t startingSeq);

247

/**

274

/**

275

   * \param recipient

276

   * \param tid

277

   * \return the sequence number of the next retry packet for a specific agreement

278

248

   * Returns the sequence number of the next retry packet for a specific agreement.

279

   * Returns the sequence number of the next retry packet for a specific agreement.

249

   * If there are no packets that need retransmission for the specified agreement or

280

   * If there are no packets that need retransmission for the specified agreement or

250

   * the agreement doesn't exist the function returns 4096;

281

   * the agreement doesn't exist the function returns 4096;

Lines 252-257	Link Here

252

  uint16_t GetSeqNumOfNextRetryPacket (Mac48Address recipient, uint8_t tid) const;

283

  uint16_t GetSeqNumOfNextRetryPacket (Mac48Address recipient, uint8_t tid) const;

253

private:

284

private:

254

/**

285

/**

286

   * \param recipient

287

   * \param tid

288

   * \return a packet

289

255

   * Checks if all packets, for which a block ack agreement was established or refreshed,

290

   * Checks if all packets, for which a block ack agreement was established or refreshed,

256

   * have been transmitted. If yes, adds a pair in m_bAckReqs to indicate that

291

   * have been transmitted. If yes, adds a pair in m_bAckReqs to indicate that

257

   * at next channel access a block ack request (for established agreement

292

   * at next channel access a block ack request (for established agreement

Lines 265-281	Link Here

265

  void InactivityTimeout (Mac48Address, uint8_t);

300

  void InactivityTimeout (Mac48Address, uint8_t);

266

301

267

  struct Item;

302

  struct Item;

303

/**

304

   * typedef for a list of Item struct.

305

*/

268

  typedef std::list<Item> PacketQueue;

306

  typedef std::list<Item> PacketQueue;

307

/**

308

   * typedef for an iterator for PacketQueue.

309

*/

269

  typedef std::list<Item>::iterator PacketQueueI;

310

  typedef std::list<Item>::iterator PacketQueueI;

311

/**

312

   * typedef for a const iterator for PacketQueue.

313

*/

270

  typedef std::list<Item>::const_iterator PacketQueueCI;

314

  typedef std::list<Item>::const_iterator PacketQueueCI;

271

315

316

/**

317

   * typedef for a map between MAC address and block ACK agreement.

318

*/

272

  typedef std::map<std::pair<Mac48Address, uint8_t>,

319

  typedef std::map<std::pair<Mac48Address, uint8_t>,

273

                   std::pair<OriginatorBlockAckAgreement, PacketQueue> > Agreements;

320

                   std::pair<OriginatorBlockAckAgreement, PacketQueue> > Agreements;

321

/**

322

   * typedef for an iterator for Agreements.

323

*/

274

  typedef std::map<std::pair<Mac48Address, uint8_t>,

324

  typedef std::map<std::pair<Mac48Address, uint8_t>,

275

                   std::pair<OriginatorBlockAckAgreement, PacketQueue> >::iterator AgreementsI;

325

                   std::pair<OriginatorBlockAckAgreement, PacketQueue> >::iterator AgreementsI;

326

/**

327

   * typedef for a const iterator for Agreements.

328

*/

276

  typedef std::map<std::pair<Mac48Address, uint8_t>,

329

  typedef std::map<std::pair<Mac48Address, uint8_t>,

277

                   std::pair<OriginatorBlockAckAgreement, PacketQueue> >::const_iterator AgreementsCI;

330

                   std::pair<OriginatorBlockAckAgreement, PacketQueue> >::const_iterator AgreementsCI;

278

331

332

/**

333

   * A struct for packet, Wifi header, and timestamp.

334

   * Used in queue by block ACK manager.

335

*/

279

  struct Item

336

  struct Item

280

337

281

    Item ();

338

    Item ();

(-)a/src/wifi/model/capability-information.h (-1 / +60 lines)

Lines 28-52	Link Here

/**

/**

 * \ingroup wifi

 * \ingroup wifi

 * Capability information

*/

*/

class CapabilityInformation

class CapabilityInformation

public:

public:

  CapabilityInformation ();

  CapabilityInformation ();

/**

   * Set the Extended Service Set (ESS) bit

   * in the capability information field.

*/

  void SetEss (void);

  void SetEss (void);

/**

   * Set the Independent BSS (IBSS) bit

   * in the capability information field.

*/

  void SetIbss (void);

  void SetIbss (void);

/**

   * Check if the Extended Service Set (ESS) bit

   * in the capability information field is set to 1.

   * \return ESS bit in the capability information

   *         field is set to 1

*/

  bool IsEss (void) const;

  bool IsEss (void) const;

/**

   * Check if the Independent BSS (IBSS) bit

   * in the capability information field is set to 1.

   * \return IBSS bit in the capability information

   *         field is set to 1

*/

  bool IsIbss (void) const;

  bool IsIbss (void) const;

/**

   * Return the serialized size of capability

   * information.

   * \return the serialized size

*/

  uint32_t GetSerializedSize (void) const;

  uint32_t GetSerializedSize (void) const;

/**

   * Serialize capability information to the given buffer.

   * \param start an iterator to a buffer

   * \return an iterator to a buffer after capability information

   *         was serialized

*/

  Buffer::Iterator Serialize (Buffer::Iterator start) const;

  Buffer::Iterator Serialize (Buffer::Iterator start) const;

/**

   * Deserialize capability information from the given buffer.

   * \param start an iterator to a buffer

   * \return an iterator to a buffer after capability information

   *         was deserialized

*/

  Buffer::Iterator Deserialize (Buffer::Iterator start);

  Buffer::Iterator Deserialize (Buffer::Iterator start);

private:

private:

/**

   * Check if bit n is set to 1.

   * \param n the bit position

   * \return true if bit n is set to 1,

   *         false otherwise

*/

  bool Is (uint8_t n) const;

  bool Is (uint8_t n) const;

/**

   * Set bit n to 1.

100

101

   * \param n the bit position

102

*/

  void Set (uint8_t n);

103

  void Set (uint8_t n);

104

/**

105

   * Set bit n to 0.

106

107

   * \param n the bit position

108

*/

  void Clear (uint8_t n);

109

  void Clear (uint8_t n);

  uint16_t m_capability;

110

  uint16_t m_capability;

};

111

};

(-)a/src/wifi/model/cara-wifi-manager.cc (+6 lines)

Lines 32-37	Link Here

namespace ns3 {

namespace ns3 {

/**

 * \brief hold per-remote-station state for CARA Wifi manager.

 * This struct extends from WifiRemoteStation struct to hold additional

 * information required by the CARA Wifi manager

*/

struct CaraWifiRemoteStation : public WifiRemoteStation

struct CaraWifiRemoteStation : public WifiRemoteStation

  uint32_t m_timer;

  uint32_t m_timer;

(-)a/src/wifi/model/dca-txop.cc (+8 lines)

Lines 69-77	Link Here

  DcaTxop *m_txop;

  DcaTxop *m_txop;

};

};

/**

 * Listener for MacLow events. Forwards to DcaTxop.

*/

class DcaTxop::TransmissionListener : public MacLowTransmissionListener

class DcaTxop::TransmissionListener : public MacLowTransmissionListener

public:

public:

/**

   * Create a TransmissionListener for the given DcaTxop.

   * \param txop

*/

  TransmissionListener (DcaTxop * txop)

  TransmissionListener (DcaTxop * txop)

    : MacLowTransmissionListener (),

    : MacLowTransmissionListener (),

      m_txop (txop) {

      m_txop (txop) {

(-)a/src/wifi/model/dca-txop.h (-3 / +84 lines)

Lines 75-82	Link Here

  DcaTxop ();

  DcaTxop ();

  ~DcaTxop ();

  ~DcaTxop ();

/**

   * Set MacLow associated with this DcaTxop.

   * \param low MacLow

*/

  void SetLow (Ptr<MacLow> low);

  void SetLow (Ptr<MacLow> low);

/**

   * Set DcfManager this DcaTxop is associated to.

   * \param manager DcfManager

*/

  void SetManager (DcfManager *manager);

  void SetManager (DcfManager *manager);

/**

   * Set WifiRemoteStationsManager this DcaTxop is associated to.

   * \param remoteManager WifiRemoteStationManager

*/

  void SetWifiRemoteStationManager (Ptr<WifiRemoteStationManager> remoteManager);

  void SetWifiRemoteStationManager (Ptr<WifiRemoteStationManager> remoteManager);

/**

/**

Lines 90-95	Link Here

*/

105

*/

  void SetTxFailedCallback (TxFailed callback);

106

  void SetTxFailedCallback (TxFailed callback);

107

108

/**

109

   * Return the packet queue associated with this DcaTxop.

110

111

   * \return WifiMacQueue

112

*/

  Ptr<WifiMacQueue > GetQueue () const;

113

  Ptr<WifiMacQueue > GetQueue () const;

  virtual void SetMinCw (uint32_t minCw);

114

  virtual void SetMinCw (uint32_t minCw);

  virtual void SetMaxCw (uint32_t maxCw);

115

  virtual void SetMaxCw (uint32_t maxCw);

Lines 129-134	Link Here

129

  DcaTxop (const DcaTxop &o);

149

  DcaTxop (const DcaTxop &o);

130

150

131

  // Inherited from ns3::Object

151

  // Inherited from ns3::Object

152

/**

153

   * Return the MacLow associated with this DcaTxop.

154

155

   * \return MacLow

156

*/

132

  Ptr<MacLow> Low (void);

157

  Ptr<MacLow> Low (void);

133

  void DoInitialize ();

158

  void DoInitialize ();

134

  /* dcf notifications forwarded here */

159

  /* dcf notifications forwarded here */

Lines 137-152	Link Here

137

  void NotifyInternalCollision (void);

162

  void NotifyInternalCollision (void);

138

  void NotifyCollision (void);

163

  void NotifyCollision (void);

139

/**

164

/**

140

  * When a channel switching occurs, enqueued packets are removed.

165

   * When a channel switching occurs, enqueued packets are removed.

141

*/

166

*/

142

  void NotifyChannelSwitching (void);

167

  void NotifyChannelSwitching (void);

143

  /* event handlers */

168

169

  /* Event handlers */

170

/**

171

   * Event handler when a CTS is received.

172

173

   * \param snr

174

   * \param txMode

175

*/

144

  void GotCts (double snr, WifiMode txMode);

176

  void GotCts (double snr, WifiMode txMode);

177

/**

178

   * Event handler when a CTS timeout has occurred.

179

*/

145

  void MissedCts (void);

180

  void MissedCts (void);

181

/**

182

   * Event handler when an ACK is received.

183

184

   * \param snr

185

   * \param txMode

186

*/

146

  void GotAck (double snr, WifiMode txMode);

187

  void GotAck (double snr, WifiMode txMode);

188

/**

189

   * Event handler when an ACK is received.

190

*/

147

  void MissedAck (void);

191

  void MissedAck (void);

148

  void StartNext (void);

192

  void StartNext (void);

149

  void Cancel (void);

193

  void Cancel (void);

194

/**

195

   * Event handler when a transmission that

196

   * does not require an ACK has completed.

197

*/

150

  void EndTxNoAck (void);

198

  void EndTxNoAck (void);

151

199

152

  void RestartAccessIfNeeded (void);

200

  void RestartAccessIfNeeded (void);

Lines 155-165	Link Here

155

  bool NeedRtsRetransmission (void);

203

  bool NeedRtsRetransmission (void);

156

  bool NeedDataRetransmission (void);

204

  bool NeedDataRetransmission (void);

157

  bool NeedFragmentation (void);

205

  bool NeedFragmentation (void);

206

/**

207

   * Calculate the size of the next fragment.

208

209

   * \return the size of the next fragment

210

*/

158

  uint32_t GetNextFragmentSize (void);

211

  uint32_t GetNextFragmentSize (void);

212

/**

213

   * Calculate the size of the current fragment.

214

215

   * \return the size of the current fragment

216

*/

159

  uint32_t GetFragmentSize (void);

217

  uint32_t GetFragmentSize (void);

218

/**

219

   * Calculate the offset for the current fragment.

220

221

   * \return the offset for the current fragment

222

*/

160

  uint32_t GetFragmentOffset (void);

223

  uint32_t GetFragmentOffset (void);

224

/**

225

   * Check if the curren fragment is the last fragment.

226

227

   * \return true if the curren fragment is the last fragment,

228

   *         false otherwise

229

*/

161

  bool IsLastFragment (void);

230

  bool IsLastFragment (void);

231

/**

232

   * Continue to the next fragment. This method simply

233

   * increments the internal variable that keep track

234

   * of the current fragment number.

235

*/

162

  void NextFragment (void);

236

  void NextFragment (void);

237

/**

238

   * Get the next fragment from the packet with

239

   * appropriate Wifi header for the fragment.

240

241

   * \param hdr

242

   * \return the fragment with the current fragment number

243

*/

163

  Ptr<Packet> GetFragmentPacket (WifiMacHeader *hdr);

244

  Ptr<Packet> GetFragmentPacket (WifiMacHeader *hdr);

164

  virtual void DoDispose (void);

245

  virtual void DoDispose (void);

165

246




}


/**
 * Listener for NAV events. Forwards to DcfManager
 */

class LowDcfListener : public ns3::MacLowDcfListener
{
public:
  /**
   * Create a LowDcfListener for the given DcfManager.
   *
   * \param dcf
   */
  LowDcfListener (ns3::DcfManager *dcf)
    : m_dcf (dcf)
  {

  ns3::DcfManager *m_dcf;
};

/**
 * Listener for PHY events. Forwards to DcfManager
 */

class PhyListener : public ns3::WifiPhyListener
{
public:
  /**
   * Create a PhyListener for the given DcfManager.
   *
   * \param dcf
   */
  PhyListener (ns3::DcfManager *dcf)
    : m_dcf (dcf)
  {

(-)a/src/wifi/model/dcf-manager.h (+72 lines)

Lines 57-66	Link Here

   * Calling this method after DcfManager::Add has been called is not recommended.

   * Calling this method after DcfManager::Add has been called is not recommended.

*/

*/

  void SetAifsn (uint32_t aifsn);

  void SetAifsn (uint32_t aifsn);

/**

   * Set the minimum congestion window size.

   * \param minCw the minimum congestion window size

*/

  void SetCwMin (uint32_t minCw);

  void SetCwMin (uint32_t minCw);

/**

   * Set the maximum congestion window size.

   * \param maxCw the maximum congestion window size

*/

  void SetCwMax (uint32_t maxCw);

  void SetCwMax (uint32_t maxCw);

/**

   * Return the number of slots that make up an AIFS.

   * \return the number of slots that make up an AIFS

*/

  uint32_t GetAifsn (void) const;

  uint32_t GetAifsn (void) const;

/**

   * Return the minimum congestion window size.

   * \return the minimum congestion window size

*/

  uint32_t GetCwMin (void) const;

  uint32_t GetCwMin (void) const;

/**

   * Return the maximum congestion window size.

   * \return the maximum congestion window size

*/

  uint32_t GetCwMax (void) const;

  uint32_t GetCwMax (void) const;

/**

/**

   * Update the value of the CW variable to take into account

   * Update the value of the CW variable to take into account

Lines 286-295	Link Here

286

  void NotifyCtsTimeoutResetNow ();

311

  void NotifyCtsTimeoutResetNow ();

287

private:

312

private:

288

  void UpdateBackoff (void);

313

  void UpdateBackoff (void);

314

/**

315

   * Return the most recent time.

316

317

   * \param a

318

   * \param b

319

   * \return the most recent time

320

*/

289

  Time MostRecent (Time a, Time b) const;

321

  Time MostRecent (Time a, Time b) const;

322

/**

323

   * Return the most recent time.

324

325

   * \param a

326

   * \param b

327

   * \param c

328

   * \return the most recent time

329

*/

290

  Time MostRecent (Time a, Time b, Time c) const;

330

  Time MostRecent (Time a, Time b, Time c) const;

331

/**

332

   * Return the most recent time.

333

334

   * \param a

335

   * \param b

336

   * \param c

337

   * \param d

338

   * \return the most recent time

339

*/

291

  Time MostRecent (Time a, Time b, Time c, Time d) const;

340

  Time MostRecent (Time a, Time b, Time c, Time d) const;

341

/**

342

   * Return the most recent time.

343

344

   * \param a

345

   * \param b

346

   * \param c

347

   * \param d

348

   * \param e

349

   * \param f

350

   * \return the most recent time

351

*/

292

  Time MostRecent (Time a, Time b, Time c, Time d, Time e, Time f) const;

352

  Time MostRecent (Time a, Time b, Time c, Time d, Time e, Time f) const;

353

/**

354

   * Return the most recent time.

355

356

   * \param a

357

   * \param b

358

   * \param c

359

   * \param d

360

   * \param e

361

   * \param f

362

   * \param g

363

   * \return the most recent time

364

*/

293

  Time MostRecent (Time a, Time b, Time c, Time d, Time e, Time f, Time g) const;

365

  Time MostRecent (Time a, Time b, Time c, Time d, Time e, Time f, Time g) const;

294

/**

366

/**

295

   * Access will never be granted to the medium _before_

367

   * Access will never be granted to the medium _before_

(-)a/src/wifi/model/dcf.h (+31 lines)

Lines 34-44	Link Here

public:

public:

  static TypeId GetTypeId (void);

  static TypeId GetTypeId (void);

/**

   * Set the minimum congestion window size.

   * \param minCw the minimum congestion window size

*/

  virtual void SetMinCw (uint32_t minCw) = 0;

  virtual void SetMinCw (uint32_t minCw) = 0;

/**

   * Set the maximum congestion window size.

   * \param maxCw the maximum congestion window size

*/

  virtual void SetMaxCw (uint32_t maxCw) = 0;

  virtual void SetMaxCw (uint32_t maxCw) = 0;

/**

   * \param aifsn the number of slots which make up an AIFS for a specific DCF.

   *        a DIFS corresponds to an AIFSN = 2.

   * Calling this method after DcfManager::Add has been called is not recommended.

*/

  virtual void SetAifsn (uint32_t aifsn) = 0;

  virtual void SetAifsn (uint32_t aifsn) = 0;

/**

   * Return the minimum congestion window size.

   * \return the minimum congestion window size

*/

  virtual uint32_t GetMinCw (void) const = 0;

  virtual uint32_t GetMinCw (void) const = 0;

/**

   * Return the maximum congestion window size.

   * \return the maximum congestion window size

*/

  virtual uint32_t GetMaxCw (void) const = 0;

  virtual uint32_t GetMaxCw (void) const = 0;

/**

   * Return the number of slots that make up an AIFS.

   * \return the number of slots that make up an AIFS

*/

  virtual uint32_t GetAifsn (void) const = 0;

  virtual uint32_t GetAifsn (void) const = 0;

};

};

(-)a/src/wifi/model/edca-txop-n.h (-3 / +123 lines)

Lines 88-102	Link Here

  virtual ~EdcaTxopN ();

  virtual ~EdcaTxopN ();

  void DoDispose ();

  void DoDispose ();

/**

   * Set MacLow associated with this EdcaTxopN.

   * \param low MacLow

*/

  void SetLow (Ptr<MacLow> low);

  void SetLow (Ptr<MacLow> low);

  void SetTxMiddle (MacTxMiddle *txMiddle);

  void SetTxMiddle (MacTxMiddle *txMiddle);

/**

   * Set DcfManager this EdcaTxopN is associated to.

100

101

   * \param manager DcfManager

102

*/

  void SetManager (DcfManager *manager);

103

  void SetManager (DcfManager *manager);

  void SetTxOkCallback (TxOk callback);

104

  void SetTxOkCallback (TxOk callback);

  void SetTxFailedCallback (TxFailed callback);

105

  void SetTxFailedCallback (TxFailed callback);

106

/**

107

   * Set WifiRemoteStationsManager this EdcaTxopN is associated to.

108

109

   * \param remoteManager WifiRemoteStationManager

110

*/

  void SetWifiRemoteStationManager (Ptr<WifiRemoteStationManager> remoteManager);

111

  void SetWifiRemoteStationManager (Ptr<WifiRemoteStationManager> remoteManager);

  void SetTypeOfStation (enum TypeOfStation type);

112

  void SetTypeOfStation (enum TypeOfStation type);

  enum TypeOfStation GetTypeOfStation (void) const;

113

  enum TypeOfStation GetTypeOfStation (void) const;

114

115

/**

116

   * Return the packet queue associated with this EdcaTxopN.

117

118

   * \return WifiMacQueue

119

*/

100

  Ptr<WifiMacQueue > GetQueue () const;

120

  Ptr<WifiMacQueue > GetQueue () const;

101

  virtual void SetMinCw (uint32_t minCw);

121

  virtual void SetMinCw (uint32_t minCw);

102

  virtual void SetMaxCw (uint32_t maxCw);

122

  virtual void SetMaxCw (uint32_t maxCw);

Lines 105-110	Link Here

105

  virtual uint32_t GetMaxCw (void) const;

125

  virtual uint32_t GetMaxCw (void) const;

106

  virtual uint32_t GetAifsn (void) const;

126

  virtual uint32_t GetAifsn (void) const;

107

127

128

/**

129

   * Return the MacLow associated with this EdcaTxopN.

130

131

   * \return MacLow

132

*/

108

  Ptr<MacLow> Low (void);

133

  Ptr<MacLow> Low (void);

109

  Ptr<MsduAggregator> GetMsduAggregator (void) const;

134

  Ptr<MsduAggregator> GetMsduAggregator (void) const;

110

135

Lines 114-134	Link Here

114

  void NotifyInternalCollision (void);

139

  void NotifyInternalCollision (void);

115

  void NotifyCollision (void);

140

  void NotifyCollision (void);

116

/**

141

/**

117

  * When a channel switching occurs, enqueued packets are removed.

142

   * When a channel switching occurs, enqueued packets are removed.

118

*/

143

*/

119

  void NotifyChannelSwitching (void);

144

  void NotifyChannelSwitching (void);

120

145

121

  /*event handlers*/

146

  /* Event handlers */

147

/**

148

   * Event handler when a CTS is received.

149

150

   * \param snr

151

   * \param txMode

152

*/

122

  void GotCts (double snr, WifiMode txMode);

153

  void GotCts (double snr, WifiMode txMode);

154

/**

155

   * Event handler when a CTS timeout has occurred.

156

*/

123

  void MissedCts (void);

157

  void MissedCts (void);

158

/**

159

   * Event handler when an ACK is received.

160

161

   * \param snr

162

   * \param txMode

163

*/

124

  void GotAck (double snr, WifiMode txMode);

164

  void GotAck (double snr, WifiMode txMode);

165

/**

166

   * Event handler when a Block ACK is received.

167

168

   * \param blockAck

169

   * \param recipient

170

*/

125

  void GotBlockAck (const CtrlBAckResponseHeader *blockAck, Mac48Address recipient);

171

  void GotBlockAck (const CtrlBAckResponseHeader *blockAck, Mac48Address recipient);

172

/**

173

   * Event handler when a Block ACK timeout has occurred.

174

*/

126

  void MissedBlockAck (void);

175

  void MissedBlockAck (void);

127

  void GotAddBaResponse (const MgtAddBaResponseHeader *respHdr, Mac48Address recipient);

176

  void GotAddBaResponse (const MgtAddBaResponseHeader *respHdr, Mac48Address recipient);

128

  void GotDelBaFrame (const MgtDelBaHeader *delBaHdr, Mac48Address recipient);

177

  void GotDelBaFrame (const MgtDelBaHeader *delBaHdr, Mac48Address recipient);

178

/**

179

   * Event handler when an ACK is received.

180

*/

129

  void MissedAck (void);

181

  void MissedAck (void);

130

  void StartNext (void);

182

  void StartNext (void);

131

  void Cancel (void);

183

  void Cancel (void);

184

/**

185

   * Event handler when a transmission that

186

   * does not require an ACK has completed.

187

*/

132

  void EndTxNoAck (void);

188

  void EndTxNoAck (void);

133

189

134

  void RestartAccessIfNeeded (void);

190

  void RestartAccessIfNeeded (void);

Lines 137-155	Link Here

137

  bool NeedRtsRetransmission (void);

193

  bool NeedRtsRetransmission (void);

138

  bool NeedDataRetransmission (void);

194

  bool NeedDataRetransmission (void);

139

  bool NeedFragmentation (void) const;

195

  bool NeedFragmentation (void) const;

196

/**

197

   * Calculate the size of the next fragment.

198

199

   * \return the size of the next fragment

200

*/

140

  uint32_t GetNextFragmentSize (void);

201

  uint32_t GetNextFragmentSize (void);

202

/**

203

   * Calculate the size of the current fragment.

204

205

   * \return the size of the current fragment

206

*/

141

  uint32_t GetFragmentSize (void);

207

  uint32_t GetFragmentSize (void);

208

/**

209

   * Calculate the offset for the current fragment.

210

211

   * \return the offset for the current fragment

212

*/

142

  uint32_t GetFragmentOffset (void);

213

  uint32_t GetFragmentOffset (void);

214

/**

215

   * Check if the curren fragment is the last fragment.

216

217

   * \return true if the curren fragment is the last fragment,

218

   *         false otherwise

219

*/

143

  bool IsLastFragment (void) const;

220

  bool IsLastFragment (void) const;

221

/**

222

   * Continue to the next fragment. This method simply

223

   * increments the internal variable that keep track

224

   * of the current fragment number.

225

*/

144

  void NextFragment (void);

226

  void NextFragment (void);

227

/**

228

   * Get the next fragment from the packet with

229

   * appropriate Wifi header for the fragment.

230

231

   * \param hdr

232

   * \return the fragment with the current fragment number

233

*/

145

  Ptr<Packet> GetFragmentPacket (WifiMacHeader *hdr);

234

  Ptr<Packet> GetFragmentPacket (WifiMacHeader *hdr);

146

235

147

  void SetAccessCategory (enum AcIndex ac);

236

  void SetAccessCategory (enum AcIndex ac);

237

/**

238

   * \param packet packet to send

239

   * \param hdr header of packet to send.

240

241

   * Store the packet in the internal queue until it

242

   * can be sent safely.

243

*/

148

  void Queue (Ptr<const Packet> packet, const WifiMacHeader &hdr);

244

  void Queue (Ptr<const Packet> packet, const WifiMacHeader &hdr);

149

  void SetMsduAggregator (Ptr<MsduAggregator> aggr);

245

  void SetMsduAggregator (Ptr<MsduAggregator> aggr);

246

/**

247

   * \param packet packet to send

248

   * \param hdr header of packet to send.

249

250

   * Store the packet in the front of the internal queue until it

251

   * can be sent safely.

252

*/

150

  void PushFront (Ptr<const Packet> packet, const WifiMacHeader &hdr);

253

  void PushFront (Ptr<const Packet> packet, const WifiMacHeader &hdr);

254

/**

255

   * Complete block ACK configuration.

256

*/

151

  void CompleteConfig (void);

257

  void CompleteConfig (void);

258

/**

259

   * Set threshold for block ACK mechanism. If number of packets in the

260

   * queue reaches the threshold, block ACK mechanism is used.

261

262

   * \param threshold

263

*/

152

  void SetBlockAckThreshold (uint8_t threshold);

264

  void SetBlockAckThreshold (uint8_t threshold);

265

/**

266

   * Return the current threshold for block ACK mechanism.

267

268

   * \return the current threshold for block ACK mechanism

269

*/

153

  uint8_t GetBlockAckThreshold (void) const;

270

  uint8_t GetBlockAckThreshold (void) const;

154

  void SetBlockAckInactivityTimeout (uint16_t timeout);

271

  void SetBlockAckInactivityTimeout (uint16_t timeout);

155

  void SendDelbaFrame (Mac48Address addr, uint8_t tid, bool byOriginator);

272

  void SendDelbaFrame (Mac48Address addr, uint8_t tid, bool byOriginator);

Lines 174-179	Link Here

174

   * If aggregating sta is an AP

291

   * If aggregating sta is an AP

175

   *   SA = Address3

292

   *   SA = Address3

176

   *   DA = Address1

293

   *   DA = Address1

294

295

   * \param hdr

296

   * \return Mac48Address

177

*/

297

*/

178

  Mac48Address MapSrcAddressForAggregation (const WifiMacHeader &hdr);

298

  Mac48Address MapSrcAddressForAggregation (const WifiMacHeader &hdr);

179

  Mac48Address MapDestAddressForAggregation (const WifiMacHeader &hdr);

299

  Mac48Address MapDestAddressForAggregation (const WifiMacHeader &hdr);

(-)a/src/wifi/model/error-rate-model.h (+1 lines)

Lines 55-60	Link Here

   * \param mode the Wi-Fi mode the chunk is sent

   * \param mode the Wi-Fi mode the chunk is sent

   * \param snr the SNR of the chunk

   * \param snr the SNR of the chunk

   * \param nbits the number of bits in this chunk

   * \param nbits the number of bits in this chunk

   * \return probability of successfully receiving the chunk

*/

*/

  virtual double GetChunkSuccessRate (WifiMode mode, double snr, uint32_t nbits) const = 0;

  virtual double GetChunkSuccessRate (WifiMode mode, double snr, uint32_t nbits) const = 0;

};

};

(-)a/src/wifi/model/ht-capabilities.h (-1 / +11 lines)

Lines 72-84	Link Here

  void SerializeInformationField (Buffer::Iterator start) const;

  void SerializeInformationField (Buffer::Iterator start) const;

  uint8_t DeserializeInformationField (Buffer::Iterator start,

  uint8_t DeserializeInformationField (Buffer::Iterator start,

                                       uint8_t length);

                                       uint8_t length);

/*

/**

   * This information element is a bit special in that it is only

   * This information element is a bit special in that it is only

   * included if the STA is an HT STA. To support this we

   * included if the STA is an HT STA. To support this we

   * override the Serialize and GetSerializedSize methods of

   * override the Serialize and GetSerializedSize methods of

   * WifiInformationElement.

   * WifiInformationElement.

   * \param start

   * \return an iterator

*/

*/

  Buffer::Iterator Serialize (Buffer::Iterator start) const;

  Buffer::Iterator Serialize (Buffer::Iterator start) const;

/**

   * Return the serialized size of this HT capability

   * information element.

   * \return the serialized size of this HT capability

   * information element

*/

  uint16_t GetSerializedSize () const;

  uint16_t GetSerializedSize () const;

private:

private:

(-)a/src/wifi/model/ideal-wifi-manager.cc (+6 lines)

Lines 27-32	Link Here

namespace ns3 {

namespace ns3 {

/**

 * \brief hold per-remote-station state for Ideal Wifi manager.

 * This struct extends from WifiRemoteStation struct to hold additional

 * information required by the Ideal Wifi manager

*/

struct IdealWifiRemoteStation : public WifiRemoteStation

struct IdealWifiRemoteStation : public WifiRemoteStation

  double m_lastSnr;

  double m_lastSnr;




}


/**
 * Listener for PHY events. Forwards to MacLow
 */


class PhyMacLowListener : public ns3::WifiPhyListener
{
public:
  /**
   * Create a PhyMacLowListener for the given MacLow.
   *
   * \param macLow
   */
  PhyMacLowListener (ns3::MacLow *macLow)
    : m_macLow (macLow)
  {

(-)a/src/wifi/model/mac-low.h (-4 / +438 lines)

Lines 150-165	Link Here

150

  MacLowDcfListener ();

150

  MacLowDcfListener ();

151

  virtual ~MacLowDcfListener ();

151

  virtual ~MacLowDcfListener ();

152

/**

152

/**

153

   * Norify that NAV has started for the given duration.

154

153

   * \param duration duration of NAV timer

155

   * \param duration duration of NAV timer

154

*/

156

*/

155

  virtual void NavStart (Time duration) = 0;

157

  virtual void NavStart (Time duration) = 0;

156

/**

158

/**

159

   * Notify that NAV has resetted.

160

157

   * \param duration duration of NAV timer

161

   * \param duration duration of NAV timer

158

*/

162

*/

159

  virtual void NavReset (Time duration) = 0;

163

  virtual void NavReset (Time duration) = 0;

164

/**

165

   * Notify that ACK timeout has started for a given duration.

166

167

   * \param duration duration of ACK timeout

168

*/

160

  virtual void AckTimeoutStart (Time duration) = 0;

169

  virtual void AckTimeoutStart (Time duration) = 0;

170

/**

171

   * Notify that ACK timeout has resetted.

172

*/

161

  virtual void AckTimeoutReset () = 0;

173

  virtual void AckTimeoutReset () = 0;

174

/**

175

   * Notify that CTS timeout has started for a given duration.

176

177

   * \param duration duration of CTS timeout

178

*/

162

  virtual void CtsTimeoutStart (Time duration) = 0;

179

  virtual void CtsTimeoutStart (Time duration) = 0;

180

/**

181

   * Notify that CTS timeout has resetted.

182

*/

163

  virtual void CtsTimeoutReset () = 0;

183

  virtual void CtsTimeoutReset () = 0;

164

};

184

};

165

185

Lines 180-185	Link Here

180

   * agreement. Timer is reset when a frame with ack policy block ack

200

   * agreement. Timer is reset when a frame with ack policy block ack

181

   * or a block ack request are received. When this timer reaches zero

201

   * or a block ack request are received. When this timer reaches zero

182

   * this method is called and a delba frame is scheduled for transmission.

202

   * this method is called and a delba frame is scheduled for transmission.

203

204

   * \param originator MAC address of the data originator

205

   * \param tid

183

*/

206

*/

184

  virtual void BlockAckInactivityTimeout (Mac48Address originator, uint8_t tid) = 0;

207

  virtual void BlockAckInactivityTimeout (Mac48Address originator, uint8_t tid) = 0;

185

};

208

};

Lines 385-415	Link Here

385

  MacLow ();

408

  MacLow ();

386

  virtual ~MacLow ();

409

  virtual ~MacLow ();

387

410

411

/**

412

   * Set up WifiPhy associated with this MacLow.

413

414

   * \param phy WifiPhy associated with this MacLow

415

*/

388

  void SetPhy (Ptr<WifiPhy> phy);

416

  void SetPhy (Ptr<WifiPhy> phy);

417

/**

418

   * Set up WifiRemoteStationManager associated with this MacLow.

419

420

   * \param manager WifiRemoteStationManager associated with this MacLow

421

*/

389

  void SetWifiRemoteStationManager (Ptr<WifiRemoteStationManager> manager);

422

  void SetWifiRemoteStationManager (Ptr<WifiRemoteStationManager> manager);

390

423

424

/**

425

   * Set MAC address of this MacLow.

426

427

   * \param ad Mac48Address of this MacLow

428

*/

391

  void SetAddress (Mac48Address ad);

429

  void SetAddress (Mac48Address ad);

430

/**

431

   * Set ACK timeout of this MacLow.

432

433

   * \param ackTimeout ACK timeout of this MacLow

434

*/

392

  void SetAckTimeout (Time ackTimeout);

435

  void SetAckTimeout (Time ackTimeout);

436

/**

437

   * Set Basic Block ACK timeout of this MacLow.

438

439

   * \param blockAckTimeout Basic Block ACK timeout of this MacLow

440

*/

393

  void SetBasicBlockAckTimeout (Time blockAckTimeout);

441

  void SetBasicBlockAckTimeout (Time blockAckTimeout);

442

/**

443

   * Set Compressed Block ACK timeout of this MacLow.

444

445

   * \param blockAckTimeout Compressed Block ACK timeout of this MacLow

446

*/

394

  void SetCompressedBlockAckTimeout (Time blockAckTimeout);

447

  void SetCompressedBlockAckTimeout (Time blockAckTimeout);

448

/**

449

   * Enable or disable CTS-to-self capability.

450

451

   * \param enable Enable or disable CTS-to-self capability

452

*/

395

  void SetCtsToSelfSupported (bool enable);

453

  void SetCtsToSelfSupported (bool enable);

454

/**

455

   * Set CTS timeout of this MacLow.

456

457

   * \param ctsTimeout CTS timeout of this MacLow

458

*/

396

  void SetCtsTimeout (Time ctsTimeout);

459

  void SetCtsTimeout (Time ctsTimeout);

460

/**

461

   * Set Short Interframe Space (SIFS) of this MacLow.

462

463

   * \param sifs SIFS of this MacLow

464

*/

397

  void SetSifs (Time sifs);

465

  void SetSifs (Time sifs);

466

/**

467

   * Set Reduced Interframe Space (RIFS) of this MacLow.

468

469

   * \param rifs RIFS of this MacLow

470

*/

398

  void SetRifs (Time rifs);

471

  void SetRifs (Time rifs);

472

/**

473

   * Set slot duration of this MacLow.

474

475

   * \param slotTime slot duration of this MacLow

476

*/

399

  void SetSlotTime (Time slotTime);

477

  void SetSlotTime (Time slotTime);

478

/**

479

   * Set PCF Interframe Space (PIFS) of this MacLow.

480

481

   * \param pifs PIFS of this MacLow

482

*/

400

  void SetPifs (Time pifs);

483

  void SetPifs (Time pifs);

484

/**

485

   * Set the Basic Service Set Identification.

486

487

   * \param ad the BSSID

488

*/

401

  void SetBssid (Mac48Address ad);

489

  void SetBssid (Mac48Address ad);

490

/**

491

   * Enable promiscuous mode.

492

*/

402

  void SetPromisc (void);

493

  void SetPromisc (void);

494

/**

495

   * Return whether CTS-to-self capability is supported.

496

497

   * \return true if CTS-to-self is supported, false otherwise

498

*/

403

  bool GetCtsToSelfSupported () const;

499

  bool GetCtsToSelfSupported () const;

500

/**

501

   * Return the MAC address of this MacLow.

502

503

   * \return Mac48Address of this MacLow

504

*/

404

  Mac48Address GetAddress (void) const;

505

  Mac48Address GetAddress (void) const;

506

/**

507

   * Return ACK timeout of this MacLow.

508

509

   * \return ACK timeout

510

*/

405

  Time GetAckTimeout (void) const;

511

  Time GetAckTimeout (void) const;

512

/**

513

   * Return Basic Block ACK timeout of this MacLow.

514

515

   * \return Basic Block ACK timeout

516

*/

406

  Time GetBasicBlockAckTimeout () const;

517

  Time GetBasicBlockAckTimeout () const;

518

/**

519

   * Return Compressed Block ACK timeout of this MacLow.

520

521

   * \return Compressed Block ACK timeout

522

*/

407

  Time GetCompressedBlockAckTimeout () const;

523

  Time GetCompressedBlockAckTimeout () const;

524

/**

525

   * Return CTS timeout of this MacLow.

526

527

   * \return CTS timeout

528

*/

408

  Time GetCtsTimeout (void) const;

529

  Time GetCtsTimeout (void) const;

530

/**

531

   * Return Short Interframe Space (SIFS) of this MacLow.

532

533

   * \return SIFS

534

*/

409

  Time GetSifs (void) const;

535

  Time GetSifs (void) const;

536

/**

537

   * Return slot duration of this MacLow.

538

539

   * \return slot duration

540

*/

410

  Time GetSlotTime (void) const;

541

  Time GetSlotTime (void) const;

542

/**

543

   * Return PCF Interframe Space (PIFS) of this MacLow.

544

545

   * \return PIFS

546

*/

411

  Time GetPifs (void) const;

547

  Time GetPifs (void) const;

548

/**

549

   * Return Reduced Interframe Space (RIFS) of this MacLow.

550

551

   * \return RIFS

552

*/

412

  Time GetRifs (void) const;

553

  Time GetRifs (void) const;

554

/**

555

   * Return the Basic Service Set Identification.

556

557

   * \return BSSID

558

*/

413

  Mac48Address GetBssid (void) const;

559

  Mac48Address GetBssid (void) const;

414

560

415

/**

561

/**

Lines 429-434	Link Here

429

   * \param packet to send (does not include the 802.11 MAC header and checksum)

575

   * \param packet to send (does not include the 802.11 MAC header and checksum)

430

   * \param hdr header associated to the packet to send.

576

   * \param hdr header associated to the packet to send.

431

   * \param parameters transmission parameters of packet.

577

   * \param parameters transmission parameters of packet.

578

   * \return the transmission time that includes the time for the next packet transmission

432

579

433

   * This transmission time includes the time required for

580

   * This transmission time includes the time required for

434

   * the next packet transmission if one was selected.

581

   * the next packet transmission if one was selected.

Lines 513-573	Link Here

513

*/

660

*/

514

  void RegisterBlockAckListenerForAc (enum AcIndex ac, MacLowBlockAckEventListener *listener);

661

  void RegisterBlockAckListenerForAc (enum AcIndex ac, MacLowBlockAckEventListener *listener);

515

private:

662

private:

663

/**

664

   * Cancel all scheduled events. Called before beginning a transmission

665

   * or switching channel.

666

*/

516

  void CancelAllEvents (void);

667

  void CancelAllEvents (void);

668

/**

669

   * Return the total ACK size (including FCS trailer).

670

671

   * \return the total ACK size

672

*/

517

  uint32_t GetAckSize (void) const;

673

  uint32_t GetAckSize (void) const;

674

/**

675

   * Return the total Block ACK size (including FCS trailer).

676

677

   * \param type the Block ACK type

678

   * \return the total Block ACK size

679

*/

518

  uint32_t GetBlockAckSize (enum BlockAckType type) const;

680

  uint32_t GetBlockAckSize (enum BlockAckType type) const;

681

/**

682

   * Return the total RTS size (including FCS trailer).

683

684

   * \return the total RTS size

685

*/

519

  uint32_t GetRtsSize (void) const;

686

  uint32_t GetRtsSize (void) const;

687

/**

688

   * Return the total CTS size (including FCS trailer).

689

690

   * \return the total CTS size

691

*/

520

  uint32_t GetCtsSize (void) const;

692

  uint32_t GetCtsSize (void) const;

693

/**

694

   * Return the total size of the packet after WifiMacHeader and FCS trailer

695

   * have been added.

696

697

   * \param packet the packet to be encapsulated with WifiMacHeader and FCS trailer

698

   * \param hdr the WifiMacHeader

699

   * \return the total packet size

700

*/

521

  uint32_t GetSize (Ptr<const Packet> packet, const WifiMacHeader *hdr) const;

701

  uint32_t GetSize (Ptr<const Packet> packet, const WifiMacHeader *hdr) const;

702

/**

703

   * Forward the packet down to WifiPhy for transmission.

704

705

   * \param packet

706

   * \param hdr

707

   * \param txVector

708

   * \param preamble

709

*/

522

  void ForwardDown (Ptr<const Packet> packet, const WifiMacHeader *hdr,

710

  void ForwardDown (Ptr<const Packet> packet, const WifiMacHeader *hdr,

523

                    WifiTxVector txVector, WifiPreamble preamble);

711

                    WifiTxVector txVector, WifiPreamble preamble);

712

/**

713

   * Return a TXVECTOR for the RTS frame given the destination.

714

   * The function consults WifiRemoteStationManager, which controls the rate

715

   * to different destinations.

716

717

   * \param packet the packet being asked for RTS TXVECTOR

718

   * \param hdr the WifiMacHeader

719

   * \return TXVECTOR for the RTS of the given packet

720

*/

524

  WifiTxVector GetRtsTxVector (Ptr<const Packet> packet, const WifiMacHeader *hdr) const;

721

  WifiTxVector GetRtsTxVector (Ptr<const Packet> packet, const WifiMacHeader *hdr) const;

722

/**

723

   * Return a TXVECTOR for the DATA frame given the destination.

724

   * The function consults WifiRemoteStationManager, which controls the rate

725

   * to different destinations.

726

727

   * \param packet the packet being asked for TXVECTOR

728

   * \param hdr the WifiMacHeader

729

   * \return TXVECTOR for the given packet

730

*/

525

  WifiTxVector GetDataTxVector (Ptr<const Packet> packet, const WifiMacHeader *hdr) const;

731

  WifiTxVector GetDataTxVector (Ptr<const Packet> packet, const WifiMacHeader *hdr) const;

732

/**

733

   * Return a TXVECTOR for the CTS frame given the destination and the mode of the RTS

734

   * used by the sender.

735

   * The function consults WifiRemoteStationManager, which controls the rate

736

   * to different destinations.

737

738

   * \param to the MAC address of the CTS receiver

739

   * \param rtsTxMode the mode of the RTS used by the sender

740

   * \return TXVECTOR for the CTS

741

*/

526

  WifiTxVector GetCtsTxVector (Mac48Address to, WifiMode rtsTxMode) const;

742

  WifiTxVector GetCtsTxVector (Mac48Address to, WifiMode rtsTxMode) const;

743

/**

744

   * Return a TXVECTOR for the ACK frame given the destination and the mode of the DATA

745

   * used by the sender.

746

   * The function consults WifiRemoteStationManager, which controls the rate

747

   * to different destinations.

748

749

   * \param to the MAC address of the ACK receiver

750

   * \param dataTxMode the mode of the DATA used by the sender

751

   * \return TXVECTOR for the ACK

752

*/

527

  WifiTxVector GetAckTxVector (Mac48Address to, WifiMode dataTxMode) const;

753

  WifiTxVector GetAckTxVector (Mac48Address to, WifiMode dataTxMode) const;

754

/**

755

   * Return a TXVECTOR for the Block ACK frame given the destination and the mode of the DATA

756

   * used by the sender.

757

   * The function consults WifiRemoteStationManager, which controls the rate

758

   * to different destinations.

759

760

   * \param to the MAC address of the Block ACK receiver

761

   * \param dataTxMode the mode of the DATA used by the sender

762

   * \return TXVECTOR for the Block ACK

763

*/

528

  WifiTxVector GetBlockAckTxVector (Mac48Address to, WifiMode dataTxMode) const;

764

  WifiTxVector GetBlockAckTxVector (Mac48Address to, WifiMode dataTxMode) const;

529

765

766

/**

767

   * Return a TXVECTOR for the CTS-to-self frame.

768

   * The function consults WifiRemoteStationManager, which controls the rate

769

   * to different destinations.

770

771

   * \param packet the packet that requires CTS-to-self

772

   * \param hdr the Wifi header of the packet

773

   * \return TXVECTOR for the CTS-to-self operation

774

*/

530

  WifiTxVector GetCtsToSelfTxVector (Ptr<const Packet> packet, const WifiMacHeader *hdr) const;

775

  WifiTxVector GetCtsToSelfTxVector (Ptr<const Packet> packet, const WifiMacHeader *hdr) const;

531

776

777

/**

778

   * Return a TXVECTOR for the CTS frame given the destination and the mode of the RTS

779

   * used by the sender.

780

   * The function consults WifiRemoteStationManager, which controls the rate

781

   * to different destinations.

782

783

   * \param to the MAC address of the CTS receiver

784

   * \param rtsTxMode the mode of the RTS used by the sender

785

   * \return TXVECTOR for the CTS

786

*/

532

  WifiTxVector GetCtsTxVectorForRts (Mac48Address to, WifiMode rtsTxMode) const;

787

  WifiTxVector GetCtsTxVectorForRts (Mac48Address to, WifiMode rtsTxMode) const;

788

/**

789

   * Return a TXVECTOR for the Block ACK frame given the destination and the mode of the DATA

790

   * used by the sender.

791

   * The function consults WifiRemoteStationManager, which controls the rate

792

   * to different destinations.

793

794

   * \param to the MAC address of the Block ACK receiver

795

   * \param dataTxMode the mode of the DATA used by the sender

796

   * \return TXVECTOR for the Block ACK

797

*/

533

  WifiTxVector GetAckTxVectorForData (Mac48Address to, WifiMode dataTxMode) const;

798

  WifiTxVector GetAckTxVectorForData (Mac48Address to, WifiMode dataTxMode) const;

534

799

800

/**

801

   * Return the time required to transmit the CTS (including preamble and FCS).

802

803

   * \param ctsTxVector

804

   * \return the time required to transmit the CTS (including preamble and FCS)

805

*/

535

  Time GetCtsDuration (WifiTxVector ctsTxVector) const;

806

  Time GetCtsDuration (WifiTxVector ctsTxVector) const;

807

/**

808

   * Return the time required to transmit the CTS to the specified address

809

   * given the TXVECTOR of the RTS (including preamble and FCS).

810

811

   * \param to

812

   * \param rtsTxVector

813

   * \return the time required to transmit the CTS (including preamble and FCS)

814

*/

536

  Time GetCtsDuration (Mac48Address to, WifiTxVector rtsTxVector) const;

815

  Time GetCtsDuration (Mac48Address to, WifiTxVector rtsTxVector) const;

816

/**

817

   * Return the time required to transmit the ACK (including preamble and FCS).

818

819

   * \param ackTxVector

820

   * \return the time required to transmit the ACK (including preamble and FCS)

821

*/

537

  Time GetAckDuration (WifiTxVector ackTxVector) const;

822

  Time GetAckDuration (WifiTxVector ackTxVector) const;

823

/**

824

   * Return the time required to transmit the ACK to the specified address

825

   * given the TXVECTOR of the DATA (including preamble and FCS).

826

827

   * \param to

828

   * \param dataTxVector

829

   * \return the time required to transmit the ACK (including preamble and FCS)

830

*/

538

  Time GetAckDuration (Mac48Address to, WifiTxVector dataTxVector) const;

831

  Time GetAckDuration (Mac48Address to, WifiTxVector dataTxVector) const;

539

  Time GetBlockAckDuration (Mac48Address to, WifiTxVector blockAckReqTxVector, enum BlockAckType type) const;

832

  Time GetBlockAckDuration (Mac48Address to, WifiTxVector blockAckReqTxVector, enum BlockAckType type) const;

540

833

834

/**

835

   * Check if CTS-to-self mechanism should be used for the current packet.

836

837

   * \return true if CTS-to-self mechanism should be used for the current packet,

838

   *         false otherwise

839

*/

541

  bool NeedCtsToSelf (void);

840

  bool NeedCtsToSelf (void);

542

841

543

  Time CalculateOverallTxTime (Ptr<const Packet> packet,

842

  Time CalculateOverallTxTime (Ptr<const Packet> packet,

544

                               const WifiMacHeader* hdr,

843

                               const WifiMacHeader* hdr,

545

                               const MacLowTransmissionParameters &params) const;

844

                               const MacLowTransmissionParameters &params) const;

546

  void NotifyNav (Ptr<const Packet> packet,const WifiMacHeader &hdr, WifiMode txMode, WifiPreamble preamble);

845

  void NotifyNav (Ptr<const Packet> packet,const WifiMacHeader &hdr, WifiMode txMode, WifiPreamble preamble);

846

/**

847

   * Reset NAV with the given duration.

848

849

   * \param duration

850

*/

547

  void DoNavResetNow (Time duration);

851

  void DoNavResetNow (Time duration);

852

/**

853

   * Start NAV with the given duration.

854

855

   * \param duration

856

   * \return true if NAV is resetted

857

*/

548

  bool DoNavStartNow (Time duration);

858

  bool DoNavStartNow (Time duration);

859

/**

860

   * Check if NAV is zero.

861

862

   * \return true if NAV is zero,

863

   *         false otherwise

864

*/

549

  bool IsNavZero (void) const;

865

  bool IsNavZero (void) const;

866

/**

867

   * Notify DcfManager (via DcfListener) that

868

   * ACK timer should be started for the given

869

   * duration.

870

871

   * \param duration

872

*/

550

  void NotifyAckTimeoutStartNow (Time duration);

873

  void NotifyAckTimeoutStartNow (Time duration);

874

/**

875

   * Notify DcfManager (via DcfListener) that

876

   * ACK timer should be resetted.

877

*/

551

  void NotifyAckTimeoutResetNow ();

878

  void NotifyAckTimeoutResetNow ();

879

/**

880

   * Notify DcfManager (via DcfListener) that

881

   * CTS timer should be started for the given

882

   * duration.

883

884

   * \param duration

885

*/

552

  void NotifyCtsTimeoutStartNow (Time duration);

886

  void NotifyCtsTimeoutStartNow (Time duration);

887

/**

888

   * Notify DcfManager (via DcfListener) that

889

   * CTS timer should be resetted.

890

*/

553

  void NotifyCtsTimeoutResetNow ();

891

  void NotifyCtsTimeoutResetNow ();

554

892

893

/**

894

   * Reset NAV after CTS was missed when the NAV was

895

   * setted with RTS.

896

897

   * \param rtsEndRxTime

898

*/

555

  void NavCounterResetCtsMissed (Time rtsEndRxTime);

899

  void NavCounterResetCtsMissed (Time rtsEndRxTime);

900

901

  /* Event handlers */

902

/**

903

   * Event handler when normal ACK timeout occurs.

904

*/

556

  void NormalAckTimeout (void);

905

  void NormalAckTimeout (void);

906

/**

907

   * Event handler when fast ACK timeout occurs (idle).

908

*/

557

  void FastAckTimeout (void);

909

  void FastAckTimeout (void);

910

/**

911

   * Event handler when super fast ACK timeout occurs.

912

*/

558

  void SuperFastAckTimeout (void);

913

  void SuperFastAckTimeout (void);

914

/**

915

   * Event handler when fast ACK timeout occurs (busy).

916

*/

559

  void FastAckFailedTimeout (void);

917

  void FastAckFailedTimeout (void);

918

/**

919

   * Event handler when block ACK timeout occurs.

920

*/

560

  void BlockAckTimeout (void);

921

  void BlockAckTimeout (void);

922

/**

923

   * Event handler when CTS timeout occurs.

924

*/

561

  void CtsTimeout (void);

925

  void CtsTimeout (void);

926

/**

927

   * Send CTS for a CTS-to-self mechanism.

928

*/

562

  void SendCtsToSelf (void);

929

  void SendCtsToSelf (void);

930

/**

931

   * Send CTS after receiving RTS.

932

933

   * \param source

934

   * \param duration

935

   * \param txMode

936

   * \param rtsSnr

937

*/

563

  void SendCtsAfterRts (Mac48Address source, Time duration, WifiMode txMode, double rtsSnr);

938

  void SendCtsAfterRts (Mac48Address source, Time duration, WifiMode txMode, double rtsSnr);

564

  void SendAckAfterData (Mac48Address source, Time duration, WifiMode txMode, double rtsSnr);

939

/**

940

   * Send ACK after receiving DATA.

941

942

   * \param source

943

   * \param duration

944

   * \param dataTxMode

945

   * \param dataSnr

946

*/

947

  void SendAckAfterData (Mac48Address source, Time duration, WifiMode dataTxMode, double dataSnr);

948

/**

949

   * Send DATA after receiving CTS.

950

951

   * \param source

952

   * \param duration

953

   * \param txMode

954

*/

565

  void SendDataAfterCts (Mac48Address source, Time duration, WifiMode txMode);

955

  void SendDataAfterCts (Mac48Address source, Time duration, WifiMode txMode);

956

/**

957

   * Event handler that is usually scheduled to fired at the appropriate time

958

   * after completing transmissions.

959

*/

566

  void WaitSifsAfterEndTx (void);

960

  void WaitSifsAfterEndTx (void);

961

/**

962

   * A transmission that does not require an ACK has completed.

963

*/

567

  void EndTxNoAck (void);

964

  void EndTxNoAck (void);

568

965

966

/**

967

   * Send RTS to begin RTS-CTS-DATA-ACK transaction.

968

*/

569

  void SendRtsForPacket (void);

969

  void SendRtsForPacket (void);

970

/**

971

   * Send DATA packet, which can be DATA-ACK or

972

   * RTS-CTS-DATA-ACK transaction.

973

*/

570

  void SendDataPacket (void);

974

  void SendDataPacket (void);

975

/**

976

   * Start a DATA timer by scheduling appropriate

977

   * ACK timeout.

978

979

   * \param dataTxVector

980

*/

571

  void StartDataTxTimers (WifiTxVector dataTxVector);

981

  void StartDataTxTimers (WifiTxVector dataTxVector);

572

  virtual void DoDispose (void);

982

  virtual void DoDispose (void);

573

/**

983

/**

Lines 599-629	Link Here

599

   * circularly modulo 2^12.

1009

   * circularly modulo 2^12.

600

*/

1010

*/

601

  bool StoreMpduIfNeeded (Ptr<Packet> packet, WifiMacHeader hdr);

1011

  bool StoreMpduIfNeeded (Ptr<Packet> packet, WifiMacHeader hdr);

602

/*

1012

/**

603

   * Invoked after that a block ack request has been received. Looks for corresponding

1013

   * Invoked after that a block ack request has been received. Looks for corresponding

604

   * block ack agreement and creates block ack bitmap on a received packets basis.

1014

   * block ack agreement and creates block ack bitmap on a received packets basis.

1015

1016

   * \param reqHdr

1017

   * \param originator

1018

   * \param duration

1019

   * \param blockAckReqTxMode

605

*/

1020

*/

606

  void SendBlockAckAfterBlockAckRequest (const CtrlBAckRequestHeader reqHdr, Mac48Address originator,

1021

  void SendBlockAckAfterBlockAckRequest (const CtrlBAckRequestHeader reqHdr, Mac48Address originator,

607

                                         Time duration, WifiMode blockAckReqTxMode);

1022

                                         Time duration, WifiMode blockAckReqTxMode);

608

/*

1023

/**

609

   * This method creates block ack frame with header equals to <i>blockAck</i> and start its transmission.

1024

   * This method creates block ack frame with header equals to <i>blockAck</i> and start its transmission.

1025

1026

   * \param blockAck

1027

   * \param originator

1028

   * \param immediate

1029

   * \param duration

1030

   * \param blockAckReqTxMode

610

*/

1031

*/

611

  void SendBlockAckResponse (const CtrlBAckResponseHeader* blockAck, Mac48Address originator, bool immediate,

1032

  void SendBlockAckResponse (const CtrlBAckResponseHeader* blockAck, Mac48Address originator, bool immediate,

612

                             Time duration, WifiMode blockAckReqTxMode);

1033

                             Time duration, WifiMode blockAckReqTxMode);

613

/*

1034

/**

614

   * Every time that a block ack request or a packet with ack policy equals to <i>block ack</i>

1035

   * Every time that a block ack request or a packet with ack policy equals to <i>block ack</i>

615

   * are received, if a relative block ack agreement exists and the value of inactivity timeout

1036

   * are received, if a relative block ack agreement exists and the value of inactivity timeout

616

   * is not 0, the timer is reset.

1037

   * is not 0, the timer is reset.

617

   * see section 11.5.3 in IEEE802.11e for more details.

1038

   * see section 11.5.3 in IEEE802.11e for more details.

1039

1040

   * \param agreement

618

*/

1041

*/

619

  void ResetBlockAckInactivityTimerIfNeeded (BlockAckAgreement &agreement);

1042

  void ResetBlockAckInactivityTimerIfNeeded (BlockAckAgreement &agreement);

620

1043

1044

/**

1045

   * Set up WifiPhy listener for this MacLow.

1046

1047

   * \param phy the WifiPhy this MacLow is connected to

1048

*/

621

  void SetupPhyMacLowListener (Ptr<WifiPhy> phy);

1049

  void SetupPhyMacLowListener (Ptr<WifiPhy> phy);

622

1050

623

  Ptr<WifiPhy> m_phy;

1051

  Ptr<WifiPhy> m_phy;

624

  Ptr<WifiRemoteStationManager> m_stationManager;

1052

  Ptr<WifiRemoteStationManager> m_stationManager;

625

  MacLowRxCallback m_rxCallback;

1053

  MacLowRxCallback m_rxCallback;

1054

/**

1055

   * typedef for an iterator for a list of MacLowDcfListener.

1056

*/

626

  typedef std::vector<MacLowDcfListener *>::const_iterator DcfListenersCI;

1057

  typedef std::vector<MacLowDcfListener *>::const_iterator DcfListenersCI;

1058

/**

1059

   * typedef for a list of MacLowDcfListener.

1060

*/

627

  typedef std::vector<MacLowDcfListener *> DcfListeners;

1061

  typedef std::vector<MacLowDcfListener *> DcfListeners;

628

  DcfListeners m_dcfListeners;

1062

  DcfListeners m_dcfListeners;

629

1063

(-)a/src/wifi/model/mgt-headers.h (-2 / +239 lines)

Lines 43-55	Link Here

  MgtAssocRequestHeader ();

  MgtAssocRequestHeader ();

  ~MgtAssocRequestHeader ();

  ~MgtAssocRequestHeader ();

/**

   * Set the Service Set Identifier (SSID).

   * \param ssid SSID

*/

  void SetSsid (Ssid ssid);

  void SetSsid (Ssid ssid);

/**

   * Set the supported rates.

   * \param rates the supported rates

*/

  void SetSupportedRates (SupportedRates rates);

  void SetSupportedRates (SupportedRates rates);

  void SetListenInterval (uint16_t interval);

  void SetListenInterval (uint16_t interval);

/**

   * Set the HT capabilities.

   * \param htcapabilities HT capabilities

*/

  void SetHtCapabilities(HtCapabilities htcapabilities);

  void SetHtCapabilities(HtCapabilities htcapabilities);

/**

   * Return the HT capabilities.

   * \return HT capabilities

*/

  HtCapabilities GetHtCapabilities (void) const;

  HtCapabilities GetHtCapabilities (void) const;

/**

   * Return the Service Set Identifier (SSID).

   * \return SSID

*/

  Ssid GetSsid (void) const;

  Ssid GetSsid (void) const;

/**

   * Return the supported rates.

   * \return the supported rates

*/

  SupportedRates GetSupportedRates (void) const;

  SupportedRates GetSupportedRates (void) const;

  uint16_t GetListenInterval (void) const;

  uint16_t GetListenInterval (void) const;

Lines 79-90	Link Here

  MgtAssocResponseHeader ();

109

  MgtAssocResponseHeader ();

  ~MgtAssocResponseHeader ();

110

  ~MgtAssocResponseHeader ();

111

112

/**

113

   * Return the status code.

114

115

   * \return the status code

116

*/

  StatusCode GetStatusCode (void);

117

  StatusCode GetStatusCode (void);

118

/**

119

   * Return the supported rates.

120

121

   * \return the supported rates

122

*/

  SupportedRates GetSupportedRates (void);

123

  SupportedRates GetSupportedRates (void);

124

/**

125

   * Return the HT capabilities.

126

127

   * \return HT capabilities

128

*/

  HtCapabilities GetHtCapabilities (void) const;

129

  HtCapabilities GetHtCapabilities (void) const;

130

131

/**

132

   * Set the HT capabilities.

133

134

   * \param htcapabilities HT capabilities

135

*/

  void SetHtCapabilities(HtCapabilities htcapabilities);

136

  void SetHtCapabilities(HtCapabilities htcapabilities);

137

/**

138

   * Set the supported rates.

139

140

   * \param rates the supported rates

141

*/

  void SetSupportedRates (SupportedRates rates);

142

  void SetSupportedRates (SupportedRates rates);

143

/**

144

   * Set the status code.

145

146

   * \param code the status code

147

*/

  void SetStatusCode (StatusCode code);

148

  void SetStatusCode (StatusCode code);

149

  static TypeId GetTypeId (void);

150

  static TypeId GetTypeId (void);

Lines 112-123	Link Here

112

public:

172

public:

113

  ~MgtProbeRequestHeader ();

173

  ~MgtProbeRequestHeader ();

114

174

175

/**

176

   * Set the Service Set Identifier (SSID).

177

178

   * \param ssid SSID

179

*/

115

  void SetSsid (Ssid ssid);

180

  void SetSsid (Ssid ssid);

181

/**

182

   * Set the supported rates.

183

184

   * \param rates the supported rates

185

*/

116

  void SetSupportedRates (SupportedRates rates);

186

  void SetSupportedRates (SupportedRates rates);

187

/**

188

   * Return the Service Set Identifier (SSID).

189

190

   * \return SSID

191

*/

117

  Ssid GetSsid (void) const;

192

  Ssid GetSsid (void) const;

193

/**

194

   * Return the supported rates.

195

196

   * \return the supported rates

197

*/

118

  SupportedRates GetSupportedRates (void) const;

198

  SupportedRates GetSupportedRates (void) const;

119

 HtCapabilities GetHtCapabilities (void) const;

199

/**

200

   * Return the HT capabilities.

201

202

   * \return HT capabilities

203

*/

204

  HtCapabilities GetHtCapabilities (void) const;

120

205

206

/**

207

   * Set the HT capabilities.

208

209

   * \param htcapabilities HT capabilities

210

*/

121

  void SetHtCapabilities(HtCapabilities htcapabilities);

211

  void SetHtCapabilities(HtCapabilities htcapabilities);

122

  static TypeId GetTypeId (void);

212

  static TypeId GetTypeId (void);

123

  virtual TypeId GetInstanceTypeId (void) const;

213

  virtual TypeId GetInstanceTypeId (void) const;

Lines 142-156	Link Here

142

  MgtProbeResponseHeader ();

232

  MgtProbeResponseHeader ();

143

  ~MgtProbeResponseHeader ();

233

  ~MgtProbeResponseHeader ();

144

234

235

/**

236

   * Return the Service Set Identifier (SSID).

237

238

   * \return SSID

239

*/

145

  Ssid GetSsid (void) const;

240

  Ssid GetSsid (void) const;

241

/**

242

   * Return the beacon interval in microseconds unit.

243

244

   * \return beacon interval in microseconds unit

245

*/

146

  uint64_t GetBeaconIntervalUs (void) const;

246

  uint64_t GetBeaconIntervalUs (void) const;

247

/**

248

   * Return the supported rates.

249

250

   * \return the supported rates

251

*/

147

  SupportedRates GetSupportedRates (void) const;

252

  SupportedRates GetSupportedRates (void) const;

148

 HtCapabilities GetHtCapabilities (void) const;

253

/**

254

   * Return the HT capabilities.

255

256

   * \return HT capabilities

257

*/

258

  HtCapabilities GetHtCapabilities (void) const;

149

259

260

/**

261

   * Set the HT capabilities.

262

263

   * \param htcapabilities HT capabilities

264

*/

150

  void SetHtCapabilities(HtCapabilities htcapabilities);

265

  void SetHtCapabilities(HtCapabilities htcapabilities);

266

/**

267

   * Set the Service Set Identifier (SSID).

268

269

   * \param ssid SSID

270

*/

151

  void SetSsid (Ssid ssid);

271

  void SetSsid (Ssid ssid);

272

/**

273

   * Set the beacon interval in microseconds unit.

274

275

   * \param us beacon interval in microseconds unit

276

*/

152

  void SetBeaconIntervalUs (uint64_t us);

277

  void SetBeaconIntervalUs (uint64_t us);

278

/**

279

   * Set the supported rates.

280

281

   * \param rates the supported rates

282

*/

153

  void SetSupportedRates (SupportedRates rates);

283

  void SetSupportedRates (SupportedRates rates);

284

/**

285

   * Return the time stamp.

286

287

   * \return time stamp

288

*/

154

  uint64_t GetTimestamp ();

289

  uint64_t GetTimestamp ();

155

  static TypeId GetTypeId (void);

290

  static TypeId GetTypeId (void);

156

  virtual TypeId GetInstanceTypeId (void) const;

291

  virtual TypeId GetInstanceTypeId (void) const;

Lines 285-303	Link Here

285

  virtual void Serialize (Buffer::Iterator start) const;

420

  virtual void Serialize (Buffer::Iterator start) const;

286

  virtual uint32_t Deserialize (Buffer::Iterator start);

421

  virtual uint32_t Deserialize (Buffer::Iterator start);

287

422

423

/**

424

   * Enable delayed Block ACK.

425

*/

288

  void SetDelayedBlockAck ();

426

  void SetDelayedBlockAck ();

427

/**

428

   * Enable immediate Block ACK

429

*/

289

  void SetImmediateBlockAck ();

430

  void SetImmediateBlockAck ();

431

/**

432

   * Set Traffic ID (TID).

433

434

   * \param tid traffic ID

435

*/

290

  void SetTid (uint8_t tid);

436

  void SetTid (uint8_t tid);

437

/**

438

   * Set timeout.

439

440

   * \param timeout timeout

441

*/

291

  void SetTimeout (uint16_t timeout);

442

  void SetTimeout (uint16_t timeout);

292

  void SetBufferSize (uint16_t size);

443

  void SetBufferSize (uint16_t size);

293

  void SetStartingSequence (uint16_t seq);

444

  void SetStartingSequence (uint16_t seq);

445

/**

446

   * Enable or disable A-MSDU support.

447

448

   * supported enable or disable A-MSDU support

449

*/

294

  void SetAmsduSupport (bool supported);

450

  void SetAmsduSupport (bool supported);

295

451

296

  uint16_t GetStartingSequence (void) const;

452

  uint16_t GetStartingSequence (void) const;

453

/**

454

   * Return the Traffic ID (TID).

455

456

   * \return TID

457

*/

297

  uint8_t GetTid (void) const;

458

  uint8_t GetTid (void) const;

459

/**

460

   * Return whether the Block ACK policy is immediate Block ACK.

461

462

   * \return true if immediate Block ACK is being used, false otherwise

463

*/

298

  bool IsImmediateBlockAck (void) const;

464

  bool IsImmediateBlockAck (void) const;

465

/**

466

   * Return the timeout.

467

468

   * \return timeout

469

*/

299

  uint16_t GetTimeout (void) const;

470

  uint16_t GetTimeout (void) const;

300

  uint16_t GetBufferSize (void) const;

471

  uint16_t GetBufferSize (void) const;

472

/**

473

   * Return whether A-MSDU capability is supported.

474

475

   * \return true is A-MSDU is supported, false otherwise

476

*/

301

  bool IsAmsduSupported (void) const;

477

  bool IsAmsduSupported (void) const;

302

478

303

private:

479

private:

Lines 332-350	Link Here

332

  virtual void Serialize (Buffer::Iterator start) const;

508

  virtual void Serialize (Buffer::Iterator start) const;

333

  virtual uint32_t Deserialize (Buffer::Iterator start);

509

  virtual uint32_t Deserialize (Buffer::Iterator start);

334

510

511

/**

512

   * Enable delayed Block ACK.

513

*/

335

  void SetDelayedBlockAck ();

514

  void SetDelayedBlockAck ();

515

/**

516

   * Enable immediate Block ACK

517

*/

336

  void SetImmediateBlockAck ();

518

  void SetImmediateBlockAck ();

519

/**

520

   * Set Traffic ID (TID).

521

522

   * \param tid traffic ID

523

*/

337

  void SetTid (uint8_t tid);

524

  void SetTid (uint8_t tid);

525

/**

526

   * Set timeout.

527

528

   * \param timeout timeout

529

*/

338

  void SetTimeout (uint16_t timeout);

530

  void SetTimeout (uint16_t timeout);

339

  void SetBufferSize (uint16_t size);

531

  void SetBufferSize (uint16_t size);

532

/**

533

   * Set the status code.

534

535

   * \param code the status code

536

*/

340

  void SetStatusCode (StatusCode code);

537

  void SetStatusCode (StatusCode code);

538

/**

539

   * Enable or disable A-MSDU support.

540

541

   * supported enable or disable A-MSDU support

542

*/

341

  void SetAmsduSupport (bool supported);

543

  void SetAmsduSupport (bool supported);

342

544

545

/**

546

   * Return the status code.

547

548

   * \return the status code

549

*/

343

  StatusCode GetStatusCode (void) const;

550

  StatusCode GetStatusCode (void) const;

551

/**

552

   * Return the Traffic ID (TID).

553

554

   * \return TID

555

*/

344

  uint8_t GetTid (void) const;

556

  uint8_t GetTid (void) const;

557

/**

558

   * Return whether the Block ACK policy is immediate Block ACK.

559

560

   * \return true if immediate Block ACK is being used, false otherwise

561

*/

345

  bool IsImmediateBlockAck (void) const;

562

  bool IsImmediateBlockAck (void) const;

563

/**

564

   * Return the timeout.

565

566

   * \return timeout

567

*/

346

  uint16_t GetTimeout (void) const;

568

  uint16_t GetTimeout (void) const;

347

  uint16_t GetBufferSize (void) const;

569

  uint16_t GetBufferSize (void) const;

570

/**

571

   * Return whether A-MSDU capability is supported.

572

573

   * \return true is A-MSDU is supported, false otherwise

574

*/

348

  bool IsAmsduSupported (void) const;

575

  bool IsAmsduSupported (void) const;

349

576

350

private:

577

private:

Lines 378-384	Link Here

378

  virtual uint32_t Deserialize (Buffer::Iterator start);

605

  virtual uint32_t Deserialize (Buffer::Iterator start);

379

606

380

  bool IsByOriginator (void) const;

607

  bool IsByOriginator (void) const;

608

/**

609

   * Return the Traffic ID (TID).

610

611

   * \return TID

612

*/

381

  uint8_t GetTid (void) const;

613

  uint8_t GetTid (void) const;

614

/**

615

   * Set Traffic ID (TID).

616

617

   * \param tid traffic ID

618

*/

382

  void SetTid (uint8_t);

619

  void SetTid (uint8_t);

383

  void SetByOriginator (void);

620

  void SetByOriginator (void);

384

  void SetByRecipient (void);

621

  void SetByRecipient (void);

(-)a/src/wifi/model/msdu-standard-aggregator.h (-3 / +8 lines)

Lines 40-45	Link Here

   * \param aggregatedPacket Packet that will contain <i>packet</i>, if aggregation is possible,

   * \param aggregatedPacket Packet that will contain <i>packet</i>, if aggregation is possible,

   * \param src Source address of <i>packet</i>.

   * \param src Source address of <i>packet</i>.

   * \param dest Destination address of <i>packet</i>.

   * \param dest Destination address of <i>packet</i>.

   * \return true if the packet can be aggregated, false otherwise

   * This method performs an MSDU aggregation.

   * This method performs an MSDU aggregation.

   * Returns true if <i>packet</i> can be aggregated to <i>aggregatedPacket</i>, false otherwise.

   * Returns true if <i>packet</i> can be aggregated to <i>aggregatedPacket</i>, false otherwise.

Lines 47-55	Link Here

  virtual bool Aggregate (Ptr<const Packet> packet, Ptr<Packet> aggregatedPacket,

  virtual bool Aggregate (Ptr<const Packet> packet, Ptr<Packet> aggregatedPacket,

                          Mac48Address src, Mac48Address dest);

                          Mac48Address src, Mac48Address dest);

private:

private:

  /*  Calculates how much padding must be added to the end of aggregated packet,

/**

      after that a new packet is added.

   * Calculates how much padding must be added to the end of aggregated packet,

      Each A-MSDU subframe is padded so that its length is multiple of 4 octets.

   * after that a new packet is added.

   * Each A-MSDU subframe is padded so that its length is multiple of 4 octets.

   * \param packet

   * \return the number of octets required for padding

*/

*/

  uint32_t CalculatePadding (Ptr<const Packet> packet);

  uint32_t CalculatePadding (Ptr<const Packet> packet);

(-)a/src/wifi/model/nist-error-rate-model.h (+7 lines)

Lines 45-50	Link Here

  virtual double GetChunkSuccessRate (WifiMode mode, double snr, uint32_t nbits) const;

  virtual double GetChunkSuccessRate (WifiMode mode, double snr, uint32_t nbits) const;

private:

private:

/**

   * Return the coded BER for the given p and b.

   * \param p

   * \param bValue

   * \return BER

*/

  double CalculatePe (double p, uint32_t bValue) const;

  double CalculatePe (double p, uint32_t bValue) const;

/**

/**

   * Return BER of BPSK at the given SNR.

   * Return BER of BPSK at the given SNR.

(-)a/src/wifi/model/onoe-wifi-manager.cc (+6 lines)

Lines 29-34	Link Here

namespace ns3 {

namespace ns3 {

/**

 * \brief hold per-remote-station state for ONOE Wifi manager.

 * This struct extends from WifiRemoteStation struct to hold additional

 * information required by the ONOE Wifi manager

*/

struct OnoeWifiRemoteStation : public WifiRemoteStation

struct OnoeWifiRemoteStation : public WifiRemoteStation

  Time m_nextModeUpdate;

  Time m_nextModeUpdate;

(-)a/src/wifi/model/originator-block-ack-agreement.h (+3 lines)

Lines 105-110	Link Here

105

/**

105

/**

106

   * Returns true if all packets for which a block ack was negotiated have been transmitted so

106

   * Returns true if all packets for which a block ack was negotiated have been transmitted so

107

   * a block ack request is needed in order to acknowledge them.

107

   * a block ack request is needed in order to acknowledge them.

108

109

   * \return  true if all packets for which a block ack was negotiated have been transmitted,

110

   * false otherwise

108

*/

111

*/

109

  bool IsBlockAckRequestNeeded (void) const;

112

  bool IsBlockAckRequestNeeded (void) const;

110

  void CompleteExchange (void);

113

  void CompleteExchange (void);




 * For more details see table 9-1 of IEEE802.11 standard.
 *
 * \param tid the Traffic ID to be mapped to Access class
 * \return the access class for the given TID
 */
AcIndex QosUtilsMapTidToAc (uint8_t tid);


 * When an BAR is received from originator station, completed "old"
 * (see section 9.10.3 in IEEE802.11e) packets must be forwarded up before "new" packets.
 *
 * \param seqControl the sequence control field
 * \param endSequence
 * \return a unique integer for the given sequence control and end sequence
 */
uint32_t QosUtilsMapSeqControlToUniqueInteger (uint16_t seqControl, uint16_t endSequence);


 *
 * \param startingSeq the starting sequence number
 * \param seqNumber the sequence number to be checked
 * \return true if the packet is old, false otherwise
 */
bool QosUtilsIsOldPacket (uint16_t startingSeq, uint16_t seqNumber);


(-)a/src/wifi/model/rraa-wifi-manager.cc (+6 lines)

Lines 32-37	Link Here

namespace ns3 {

namespace ns3 {

/**

 * \brief hold per-remote-station state for RRAA Wifi manager.

 * This struct extends from WifiRemoteStation struct to hold additional

 * information required by the RRAA Wifi manager

*/

struct RraaWifiRemoteStation : public WifiRemoteStation

struct RraaWifiRemoteStation : public WifiRemoteStation

  uint32_t m_counter;

  uint32_t m_counter;

(-)a/src/wifi/model/ssid.h (+29 lines)

Lines 37-48	Link Here

public:

public:

  // broadcast ssid

  // broadcast ssid

  Ssid ();

  Ssid ();

/**

   * Create SSID from a given string

   * \param s SSID in string

*/

  Ssid (std::string s);

  Ssid (std::string s);

/**

   * Create SSID from a given array of char and given length.

   * \param ssid

   * \param length

*/

  Ssid (char const ssid[32], uint8_t length);

  Ssid (char const ssid[32], uint8_t length);

/**

   * Check if the two SSIDs are equal.

   * \param o SSID to compare to

   * \return true if the two SSIDs are equal,

   *         false otherwise

*/

  bool IsEqual (const Ssid& o) const;

  bool IsEqual (const Ssid& o) const;

/**

   * Check if the SSID is broadcast.

   * \return true if the SSID is broadcast,

   *         false otherwise

*/

  bool IsBroadcast (void) const;

  bool IsBroadcast (void) const;

/**

   * Peek the SSID.

   * \return a pointer to SSID string

*/

  char* PeekString (void) const;

  char* PeekString (void) const;

  WifiInformationElementId ElementId () const;

  WifiInformationElementId ElementId () const;

(-)a/src/wifi/model/status-code.h (+34 lines)

Lines 30-42	Link Here

public:

public:

  StatusCode ();

  StatusCode ();

/**

   * Set success bit to 0 (success).

*/

  void SetSuccess (void);

  void SetSuccess (void);

/**

   * Set success bit to 1 (failure.

*/

  void SetFailure (void);

  void SetFailure (void);

/**

   * Return whether the status code is success.

   * \return true if success, false otherwise

*/

  bool IsSuccess (void) const;

  bool IsSuccess (void) const;

/**

   * \returns the expected size of the status code.

   * This method should return the number of bytes which are needed to store

   * the status code data by Serialize.

*/

  uint32_t GetSerializedSize (void) const;

  uint32_t GetSerializedSize (void) const;

/**

   * \param start an iterator which points to where the status code should

   *        be written.

   * \return Buffer::Iterator

   * This method is used to store a status code into the byte buffer.

   * The data written is expected to match bit-for-bit the representation of this

   * header in a real network.

*/

  Buffer::Iterator Serialize (Buffer::Iterator start) const;

  Buffer::Iterator Serialize (Buffer::Iterator start) const;

/**

   * \param start an iterator which points to where the status code should be read.

   * \returns the number of bytes read.

   * This method is used to re-create a status code from the byte buffer.

   * The data read is expected to match bit-for-bit the representation of this

   * header in real networks.

*/

  Buffer::Iterator Deserialize (Buffer::Iterator start);

  Buffer::Iterator Deserialize (Buffer::Iterator start);

private:

private:

  uint16_t m_code;

  uint16_t m_code;

(-)a/src/wifi/model/supported-rates.h (-1 / +50 lines)

Lines 53-58	Link Here

public:

public:

  ExtendedSupportedRatesIE ();

  ExtendedSupportedRatesIE ();

/**

   * Create an extended supported rates information element

   * from the given rates.

   * \param rates

*/

  ExtendedSupportedRatesIE (SupportedRates *rates);

  ExtendedSupportedRatesIE (SupportedRates *rates);

  WifiInformationElementId ElementId () const;

  WifiInformationElementId ElementId () const;

Lines 61-73	Link Here

  uint8_t DeserializeInformationField (Buffer::Iterator start,

  uint8_t DeserializeInformationField (Buffer::Iterator start,

                                       uint8_t length);

                                       uint8_t length);

/*

/**

   * This information element is a bit special in that it is only

   * This information element is a bit special in that it is only

   * included if there are more than 8 rates. To support this we

   * included if there are more than 8 rates. To support this we

   * override the Serialize and GetSerializedSize methods of

   * override the Serialize and GetSerializedSize methods of

   * WifiInformationElement.

   * WifiInformationElement.

   * \param start

   * \return an iterator

*/

*/

  Buffer::Iterator Serialize (Buffer::Iterator start) const;

  Buffer::Iterator Serialize (Buffer::Iterator start) const;

/**

   * Return the serialized size of this supported rates

   * information element.

   * \return the serialized size of this supported rates

   * information element

*/

  uint16_t GetSerializedSize () const;

  uint16_t GetSerializedSize () const;

private:

private:

/**

/**

Lines 94-106	Link Here

public:

110

public:

  SupportedRates ();

111

  SupportedRates ();

112

113

/**

114

   * Add the given rate to the supported rates.

115

116

   * \param bs the rate to be added

117

*/

  void AddSupportedRate (uint32_t bs);

118

  void AddSupportedRate (uint32_t bs);

119

/**

120

   * Set the given rate to basic rates.

121

122

   * \param bs the rate to be set

123

*/

  void SetBasicRate (uint32_t bs);

124

  void SetBasicRate (uint32_t bs);

125

126

/**

127

   * Check if the given rate is supported.

128

129

   * \param bs the rate to be checked

130

   * \return true if the rate is supported, false otherwise

131

*/

100

  bool IsSupportedRate (uint32_t bs) const;

132

  bool IsSupportedRate (uint32_t bs) const;

133

/**

134

   * Check if the given rate is a basic rate.

135

136

   * \param bs the rate to be checked

137

   * \return true if the rate is a basic rate, false otherwise

138

*/

101

  bool IsBasicRate (uint32_t bs) const;

139

  bool IsBasicRate (uint32_t bs) const;

102

140

141

/**

142

   * Return the number of supported rates.

143

144

   * \return the number of supported rates

145

*/

103

  uint8_t GetNRates (void) const;

146

  uint8_t GetNRates (void) const;

147

/**

148

   * Return the rate at the given index.

149

150

   * \param i the given index

151

   * \return the rate

152

*/

104

  uint32_t GetRate (uint8_t i) const;

153

  uint32_t GetRate (uint8_t i) const;

105

154

106

  WifiInformationElementId ElementId () const;

155

  WifiInformationElementId ElementId () const;

(-)a/src/wifi/model/wifi-information-element-vector.h (-3 / +2 lines)

Lines 45-52	Link Here

public:

public:

  WifiInformationElementVector ();

  WifiInformationElementVector ();

  ~WifiInformationElementVector ();

  ~WifiInformationElementVector ();

  ///\name Inherited from Header

  // \{

  static TypeId GetTypeId ();

  static TypeId GetTypeId ();

  TypeId GetInstanceTypeId () const;

  TypeId GetInstanceTypeId () const;

  virtual uint32_t GetSerializedSize () const;

  virtual uint32_t GetSerializedSize () const;

Lines 59-65	Link Here

*/

*/

  virtual uint32_t Deserialize (Buffer::Iterator start);

  virtual uint32_t Deserialize (Buffer::Iterator start);

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

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

  //\}

/**

/**

   * \brief Needed when you try to deserialize a lonely IE inside other header

   * \brief Needed when you try to deserialize a lonely IE inside other header

   * \param start is the start of the buffer

   * \param start is the start of the buffer

(-)a/src/wifi/model/wifi-information-element.h (-23 / +73 lines)

Lines 131-178	Link Here

131

132

public:

132

public:

133

  virtual ~WifiInformationElement ();

133

  virtual ~WifiInformationElement ();

134

  /// Serialize entire IE including Element ID and length fields

134

/**

135

   * Serialize entire IE including Element ID and length fields

136

137

   * \param i an iterator which points to where the IE should

138

   *        be written.

139

   * \return an iterator

140

*/

135

  Buffer::Iterator Serialize (Buffer::Iterator i) const;

141

  Buffer::Iterator Serialize (Buffer::Iterator i) const;

136

  /// Deserialize entire IE, which must be present. The iterator

142

/**

137

  /// passed in must be pointing at the Element ID (i.e., the very

143

   * Deserialize entire IE, which must be present. The iterator

138

  /// first octet) of the correct type of information element,

144

   * passed in must be pointing at the Element ID (i.e., the very

139

  /// otherwise this method will generate a fatal error.

145

   * first octet) of the correct type of information element,

146

   * otherwise this method will generate a fatal error.

147

148

   * \param i an iterator which points to where the IE should be read.

149

   * \return an iterator

150

*/

140

  Buffer::Iterator Deserialize (Buffer::Iterator i);

151

  Buffer::Iterator Deserialize (Buffer::Iterator i);

141

  /// Deserialize entire IE if it is present. The iterator passed in

152

/**

142

  /// must be pointing at the Element ID of an information element. If

153

   * Deserialize entire IE if it is present. The iterator passed in

143

  /// the Element ID is not the one that the given class is interested

154

   * must be pointing at the Element ID of an information element. If

144

  /// in then it will return the same iterator.

155

   * the Element ID is not the one that the given class is interested

156

   * in then it will return the same iterator.

157

158

   * \param i an iterator which points to where the IE should be read.

159

   * \return an iterator

160

*/

145

  Buffer::Iterator DeserializeIfPresent (Buffer::Iterator i);

161

  Buffer::Iterator DeserializeIfPresent (Buffer::Iterator i);

146

  /// Get the size of the serialized IE including Element ID and

162

/**

147

  /// length fields.

163

   * Get the size of the serialized IE including Element ID and

164

   * length fields.

165

166

   * \return the size of the serialized IE

167

*/

148

  uint16_t GetSerializedSize () const;

168

  uint16_t GetSerializedSize () const;

149

169

150

  ///\name Each subclass must implement

170

  ///\name Each subclass must implement

151

  //\{

171

  //\{

152

  /// Own unique Element ID

172

  /// Own unique Element ID

153

  virtual WifiInformationElementId ElementId () const = 0;

173

  virtual WifiInformationElementId ElementId () const = 0;

154

  /// Length of serialized information (i.e., the length of the body

174

/**

155

  /// of the IE, not including the Element ID and length octets. This

175

   * Length of serialized information (i.e., the length of the body

156

  /// is the value that will appear in the second octet of the entire

176

   * of the IE, not including the Element ID and length octets. This

157

  /// IE - the length field)

177

   * is the value that will appear in the second octet of the entire

178

   * IE - the length field)

179

180

   * \return the length of serialized information

181

*/

158

  virtual uint8_t GetInformationFieldSize () const = 0;

182

  virtual uint8_t GetInformationFieldSize () const = 0;

159

  /// Serialize information (i.e., the body of the IE, not including

183

/**

160

  /// the Element ID and length octets)

184

   * Serialize information (i.e., the body of the IE, not including

185

   * the Element ID and length octets)

186

187

   * \param start an iterator which points to where the information should

188

   *        be written.

189

*/

161

  virtual void SerializeInformationField (Buffer::Iterator start) const = 0;

190

  virtual void SerializeInformationField (Buffer::Iterator start) const = 0;

162

  /// Deserialize information (i.e., the body of the IE, not including

191

/**

163

  /// the Element ID and length octets)

192

   * Deserialize information (i.e., the body of the IE, not including

193

   * the Element ID and length octets)

194

195

   * \param start an iterator which points to where the information should

196

   *        be written.

197

   * \param length

198

   * \return the number of bytes read

199

*/

164

  virtual uint8_t DeserializeInformationField (Buffer::Iterator start,

200

  virtual uint8_t DeserializeInformationField (Buffer::Iterator start,

165

                                               uint8_t length) = 0;

201

                                               uint8_t length) = 0;

166

  //\}

202

  //\}

167

203

168

  /// In addition, a subclass may optionally override the following...

204

  /// In addition, a subclass may optionally override the following...

169

  //\{

205

  //\{

170

  /// Generate human-readable form of IE

206

/**

207

   * Generate human-readable form of IE

208

209

   * \param os output stream

210

*/

171

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

211

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

172

  /// Compare information elements using Element ID

212

/**

213

   * Compare information elements using Element ID

214

215

   * \param a another information element to compare with

216

   * \return true if the Element ID is less than the other IE Element ID,

217

   *         false otherwise

218

*/

173

  virtual bool operator< (WifiInformationElement const & a) const;

219

  virtual bool operator< (WifiInformationElement const & a) const;

174

  /// Compare two IEs for equality by ID & Length, and then through

220

/**

175

  /// memcmp of serialised version

221

   * Compare two IEs for equality by ID & Length, and then through

222

   * memcmp of serialised version

223

224

   * \return true if the two IEs are equal, false otherwise

225

*/

176

  virtual bool operator== (WifiInformationElement const & a) const;

226

  virtual bool operator== (WifiInformationElement const & a) const;

177

  //\}

227

  //\}

178

};

228

};

(-)a/src/wifi/model/wifi-mac-header.h (-1 / +55 lines)

Lines 29-34	Link Here

namespace ns3 {

namespace ns3 {

/**

 * Combination of valid MAC header type/subtype.

*/

enum WifiMacType

enum WifiMacType

  WIFI_MAC_CTL_RTS = 0,

  WIFI_MAC_CTL_RTS = 0,

Lines 77-82	Link Here

class WifiMacHeader : public Header

class WifiMacHeader : public Header

public:

public:

/**

   * ACK policy for QoS frames.

*/

  enum QosAckPolicy

  enum QosAckPolicy

    NORMAL_ACK = 0,

    NORMAL_ACK = 0,

Lines 85-90	Link Here

    BLOCK_ACK = 3,

    BLOCK_ACK = 3,

};

};

/**

   * Address types.

*/

  enum AddressType

  enum AddressType

    ADDR1,

    ADDR1,

Lines 140-145	Link Here

140

   * Set Type/Subtype values for a Block Ack header.

149

   * Set Type/Subtype values for a Block Ack header.

141

*/

150

*/

142

  void SetBlockAck (void);

151

  void SetBlockAck (void);

152

/**

153

   * Set Type/Subtype values for a multihop action header.

154

*/

143

  void SetMultihopAction ();

155

  void SetMultihopAction ();

144

/**

156

/**

145

   * Set the From DS bit in the Frame Control field.

157

   * Set the From DS bit in the Frame Control field.

Lines 251-258	Link Here

251

  void SetQosNoEosp ();

263

  void SetQosNoEosp ();

252

/**

264

/**

253

   * Set the QoS ACK policy in the QoS control field.

265

   * Set the QoS ACK policy in the QoS control field.

266

267

   * \param policy

254

*/

268

*/

255

  void SetQosAckPolicy (enum QosAckPolicy);

269

  void SetQosAckPolicy (enum QosAckPolicy policy);

256

/**

270

/**

257

   * Set the QoS ACK policy in the QoS control field to normal ACK.

271

   * Set the QoS ACK policy in the QoS control field to normal ACK.

258

*/

272

*/

Lines 265-274	Link Here

265

   * Set the QoS ACK policy in the QoS control field to no ACK.

279

   * Set the QoS ACK policy in the QoS control field to no ACK.

266

*/

280

*/

267

  void SetQosNoAck (void);

281

  void SetQosNoAck (void);

282

/**

283

   * Set that A-MSDU is present.

284

*/

268

  void SetQosAmsdu (void);

285

  void SetQosAmsdu (void);

286

/**

287

   * Set that A-MSDU is not present.

288

*/

269

  void SetQosNoAmsdu (void);

289

  void SetQosNoAmsdu (void);

290

/**

291

   * Set TXOP limit in the QoS control field.

292

293

   * \param txop

294

*/

270

  void SetQosTxopLimit (uint8_t txop);

295

  void SetQosTxopLimit (uint8_t txop);

296

/**

297

   * Set order bit in the frame control field.

298

*/

271

  void SetOrder (void);

299

  void SetOrder (void);

300

/**

301

   * Unset order bit in the frame control field.

302

*/

272

  void SetNoOrder (void);

303

  void SetNoOrder (void);

273

304

274

/**

305

/**

Lines 438-443	Link Here

438

   * \return true if the header is an Action header, false otherwise

469

   * \return true if the header is an Action header, false otherwise

439

*/

470

*/

440

  bool IsAction () const;

471

  bool IsAction () const;

472

/**

473

   * Check if the header is a Multihop action header.

474

475

   * \return true if the header is a Multihop action header,

476

   *         false otherwise

477

*/

441

  bool IsMultihopAction () const;

478

  bool IsMultihopAction () const;

442

/**

479

/**

443

   * Return the raw duration from the Duration/ID field.

480

   * Return the raw duration from the Duration/ID field.

Lines 505-510	Link Here

505

   * \return true if the end of service period (EOSP) is set, false otherwise

542

   * \return true if the end of service period (EOSP) is set, false otherwise

506

*/

543

*/

507

  bool IsQosEosp (void) const;

544

  bool IsQosEosp (void) const;

545

/**

546

   * Check if the A-MSDU present bit is set in the QoS control field.

547

548

   * \return true if the A-MSDU present bit is set,

549

   *        false otherwise

550

*/

508

  bool IsQosAmsdu (void) const;

551

  bool IsQosAmsdu (void) const;

509

/**

552

/**

510

   * Return the Traffic ID of a QoS header.

553

   * Return the Traffic ID of a QoS header.

Lines 518-525	Link Here

518

   * \return the QoS ACK Policy of a QoS header

561

   * \return the QoS ACK Policy of a QoS header

519

*/

562

*/

520

  enum QosAckPolicy GetQosAckPolicy (void) const;

563

  enum QosAckPolicy GetQosAckPolicy (void) const;

564

/**

565

   * Return the TXOP limit.

566

567

   * \return the TXOP limit

568

*/

521

  uint8_t GetQosTxopLimit (void) const;

569

  uint8_t GetQosTxopLimit (void) const;

522

570

571

/**

572

   * Return the size of the WifiMacHeader in octets.

573

   * GetSerializedSize calls this function.

574

575

   * \return the size of the WifiMacHeader in octets

576

*/

523

  uint32_t GetSize (void) const;

577

  uint32_t GetSize (void) const;

524

/**

578

/**

525

   * Return a string corresponds to the header type.

579

   * Return a string corresponds to the header type.

(-)a/src/wifi/model/wifi-mac-queue.h (-4 / +120 lines)

Lines 56-69	Link Here

  WifiMacQueue ();

  WifiMacQueue ();

  ~WifiMacQueue ();

  ~WifiMacQueue ();

/**

   * Set the maximum queue size.

   * \param maxSize the maximum queue size

*/

  void SetMaxSize (uint32_t maxSize);

  void SetMaxSize (uint32_t maxSize);

/**

   * Set the maximum delay before the packet is discarded.

   * \param delay the maximum delay

*/

  void SetMaxDelay (Time delay);

  void SetMaxDelay (Time delay);

/**

   * Return the maximum queue size.

   * \return the maximum queue size

*/

  uint32_t GetMaxSize (void) const;

  uint32_t GetMaxSize (void) const;

/**

   * Return the maximum delay before the packet is discarded.

   * \return the maximum delay

*/

  Time GetMaxDelay (void) const;

  Time GetMaxDelay (void) const;

/**

   * Enqueue the given packet and its corresponding WifiMacHeader at the <i>end</i> of the queue.

   * \param packet the packet to be euqueued at the end

   * \param hdr the header of the given packet

*/

  void Enqueue (Ptr<const Packet> packet, const WifiMacHeader &hdr);

  void Enqueue (Ptr<const Packet> packet, const WifiMacHeader &hdr);

/**

   * Enqueue the given packet and its corresponding WifiMacHeader at the <i>front</i> of the queue.

   * \param packet the packet to be euqueued at the end

   * \param hdr the header of the given packet

*/

  void PushFront (Ptr<const Packet> packet, const WifiMacHeader &hdr);

  void PushFront (Ptr<const Packet> packet, const WifiMacHeader &hdr);

/**

   * Dequeue the packet in the front of the queue.

100

101

   * \param hdr the WifiMacHeader of the packet

102

   * \return the packet

103

*/

  Ptr<const Packet> Dequeue (WifiMacHeader *hdr);

104

  Ptr<const Packet> Dequeue (WifiMacHeader *hdr);

105

/**

106

   * Peek the packet in the front of the queue. The packet is not removed.

107

108

   * \param hdr the WifiMacHeader of the packet

109

   * \return the packet

110

*/

  Ptr<const Packet> Peek (WifiMacHeader *hdr);

111

  Ptr<const Packet> Peek (WifiMacHeader *hdr);

/**

112

/**

   * Searchs and returns, if is present in this queue, first packet having

113

   * Searchs and returns, if is present in this queue, first packet having

Lines 71-76	Link Here

   * equals to <i>tid</i>. This method removes the packet from this queue.

115

   * equals to <i>tid</i>. This method removes the packet from this queue.

   * Is typically used by ns3::EdcaTxopN in order to perform correct MSDU

116

   * Is typically used by ns3::EdcaTxopN in order to perform correct MSDU

   * aggregation (A-MSDU).

117

   * aggregation (A-MSDU).

118

119

   * \param hdr the header of the dequeued packet

120

   * \param tid the given TID

121

   * \param type the given address type

122

   * \param addr the given destination

123

   * \return packet

*/

124

*/

  Ptr<const Packet> DequeueByTidAndAddress (WifiMacHeader *hdr,

125

  Ptr<const Packet> DequeueByTidAndAddress (WifiMacHeader *hdr,

                                            uint8_t tid,

126

                                            uint8_t tid,

Lines 82-87	Link Here

   * equals to <i>tid</i>. This method doesn't remove the packet from this queue.

132

   * equals to <i>tid</i>. This method doesn't remove the packet from this queue.

   * Is typically used by ns3::EdcaTxopN in order to perform correct MSDU

133

   * Is typically used by ns3::EdcaTxopN in order to perform correct MSDU

   * aggregation (A-MSDU).

134

   * aggregation (A-MSDU).

135

136

   * \param hdr the header of the dequeued packet

137

   * \param tid the given TID

138

   * \param type the given address type

139

   * \param addr the given destination

140

   * \return packet

*/

141

*/

  Ptr<const Packet> PeekByTidAndAddress (WifiMacHeader *hdr,

142

  Ptr<const Packet> PeekByTidAndAddress (WifiMacHeader *hdr,

                                         uint8_t tid,

143

                                         uint8_t tid,

Lines 91-101	Link Here

   * If exists, removes <i>packet</i> from queue and returns true. Otherwise it

147

   * If exists, removes <i>packet</i> from queue and returns true. Otherwise it

   * takes no effects and return false. Deletion of the packet is

148

   * takes no effects and return false. Deletion of the packet is

   * performed in linear time (O(n)).

149

   * performed in linear time (O(n)).

150

151

   * \param packet the packet to be removed

152

   * \return true if the packet was removed, false otherwise

*/

153

*/

  bool Remove (Ptr<const Packet> packet);

154

  bool Remove (Ptr<const Packet> packet);

/**

155

/**

   * Returns number of QoS packets having tid equals to <i>tid</i> and address

156

   * Returns number of QoS packets having tid equals to <i>tid</i> and address

   * specified by <i>type</i> equals to <i>addr</i>.

157

   * specified by <i>type</i> equals to <i>addr</i>.

158

159

   * \param tid the given TID

160

   * \param type the given address type

161

   * \param addr the given destination

162

   * \return the number of QoS packets

*/

163

*/

100

  uint32_t GetNPacketsByTidAndAddress (uint8_t tid,

164

  uint32_t GetNPacketsByTidAndAddress (uint8_t tid,

101

                                       WifiMacHeader::AddressType type,

165

                                       WifiMacHeader::AddressType type,

Lines 106-137	Link Here

106

   * respectively that index a pending agreement in the BlockAckManager object.

170

   * respectively that index a pending agreement in the BlockAckManager object.

107

   * So that packet must not be transmitted until reception of an ADDBA response frame from station

171

   * So that packet must not be transmitted until reception of an ADDBA response frame from station

108

   * addressed by <i>addr</i>. This method removes the packet from queue.

172

   * addressed by <i>addr</i>. This method removes the packet from queue.

173

174

   * \param hdr the header of the dequeued packet

175

   * \param tStamp

176

   * \param blockedPackets

177

   * \return packet

109

*/

178

*/

110

  Ptr<const Packet> DequeueFirstAvailable (WifiMacHeader *hdr,

179

  Ptr<const Packet> DequeueFirstAvailable (WifiMacHeader *hdr,

111

                                           Time &tStamp,

180

                                           Time &tStamp,

112

                                           const QosBlockedDestinations *blockedPackets);

181

                                           const QosBlockedDestinations *blockedPackets);

113

/**

182

/**

114

   * Returns first available packet for transmission. The packet isn't removed from queue.

183

   * Returns first available packet for transmission. The packet isn't removed from queue.

184

185

   * \param hdr the header of the dequeued packet

186

   * \param tStamp

187

   * \param blockedPackets

188

   * \return packet

115

*/

189

*/

116

  Ptr<const Packet> PeekFirstAvailable (WifiMacHeader *hdr,

190

  Ptr<const Packet> PeekFirstAvailable (WifiMacHeader *hdr,

117

                                        Time &tStamp,

191

                                        Time &tStamp,

118

                                        const QosBlockedDestinations *blockedPackets);

192

                                        const QosBlockedDestinations *blockedPackets);

193

/**

194

   * Flush the queue.

195

*/

119

  void Flush (void);

196

  void Flush (void);

120

197

198

/**

199

   * Return if the queue is empty.

200

201

   * \return true if the queue is empty, false otherwise

202

*/

121

  bool IsEmpty (void);

203

  bool IsEmpty (void);

204

/**

205

   * Return the current queue size.

206

207

   * \return the current queue size

208

*/

122

  uint32_t GetSize (void);

209

  uint32_t GetSize (void);

123

private:

210

private:

124

  struct Item;

211

  struct Item;

125

212

213

/**

214

   * typedef for packet (struct Item) queue.

215

*/

126

  typedef std::list<struct Item> PacketQueue;

216

  typedef std::list<struct Item> PacketQueue;

217

/**

218

   * typedef for packet (struct Item) queue reverse iterator.

219

*/

127

  typedef std::list<struct Item>::reverse_iterator PacketQueueRI;

220

  typedef std::list<struct Item>::reverse_iterator PacketQueueRI;

221

/**

222

   * typedef for packet (struct Item) queue iterator.

223

*/

128

  typedef std::list<struct Item>::iterator PacketQueueI;

224

  typedef std::list<struct Item>::iterator PacketQueueI;

225

/**

226

   * Clean up the queue by removing packets that exceeded the maximum delay.

227

*/

228

  void Cleanup (void);

229

/**

230

   * Return the appropriate address for the given packet (given by PacketQueue iterator).

231

232

   * \param type

233

   * \param it

234

   * \return the address

235

*/

236

  Mac48Address GetAddressForPacket (enum WifiMacHeader::AddressType type, PacketQueueI it);

129

237

130

  void Cleanup (void);

238

/**

131

  Mac48Address GetAddressForPacket (enum WifiMacHeader::AddressType type, PacketQueueI);

239

   * A struct that holds information about a packet for putting

132

240

   * in a packet queue.

241

*/

133

  struct Item

242

  struct Item

134

243

244

/**

245

     * Create a struct with the given parameters.

246

247

     * \param packet

248

     * \param hdr

249

     * \param tstamp

250

*/

135

    Item (Ptr<const Packet> packet,

251

    Item (Ptr<const Packet> packet,

136

          const WifiMacHeader &hdr,

252

          const WifiMacHeader &hdr,

137

          Time tstamp);

253

          Time tstamp);




   *        associated WifiMode is used.
   * \param dataRate the rate (bits/second) at which the user data is transmitted
   * \param codingRate if convolutional coding is used for this rate
   *        then this parameter specifies the convolutional coding rate
   *        used. If there is no explicit convolutional coding step (e.g.,
   *        for DSSS rates) then the caller should set this parameter to
   *        WIFI_CODE_RATE_UNCODED.
   * \param constellationSize the order of the constellation used.
   * \return WifiMode
   *
   * Create a WifiMode.
   */

(-)a/src/wifi/model/wifi-phy-state-helper.h (+118 lines)

Lines 42-63	Link Here

  void SetReceiveOkCallback (WifiPhy::RxOkCallback callback);

  void SetReceiveOkCallback (WifiPhy::RxOkCallback callback);

  void SetReceiveErrorCallback (WifiPhy::RxErrorCallback callback);

  void SetReceiveErrorCallback (WifiPhy::RxErrorCallback callback);

  void RegisterListener (WifiPhyListener *listener);

  void RegisterListener (WifiPhyListener *listener);

/**

   * Return the current state of WifiPhy.

   * \return the current state of WifiPhy

*/

  enum WifiPhy::State GetState (void);

  enum WifiPhy::State GetState (void);

/**

   * Check whether the current state is CCA busy.

   * \return true if the current state is CCA busy, false otherwise

*/

  bool IsStateCcaBusy (void);

  bool IsStateCcaBusy (void);

/**

   * Check whether the current state is IDLE.

   * \return true if the current state is IDLE, false otherwise

*/

  bool IsStateIdle (void);

  bool IsStateIdle (void);

/**

   * Check whether the current state is not IDLE.

   * \return true if the current state is not IDLE, false otherwise

*/

  bool IsStateBusy (void);

  bool IsStateBusy (void);

/**

   * Check whether the current state is RX.

   * \return true if the current state is RX, false otherwise

*/

  bool IsStateRx (void);

  bool IsStateRx (void);

/**

   * Check whether the current state is TX.

   * \return true if the current state is TX, false otherwise

*/

  bool IsStateTx (void);

  bool IsStateTx (void);

/**

   * Check whether the current state is SWITCHING.

   * \return true if the current state is SWITCHING, false otherwise

*/

  bool IsStateSwitching (void);

  bool IsStateSwitching (void);

/**

   * Return the elapsed time of the current state.

   * \return the elapsed time of the current state

*/

  Time GetStateDuration (void);

  Time GetStateDuration (void);

/**

   * Return the time before the state is back to IDLE.

   * \return the delay before the state is back to IDLE

*/

  Time GetDelayUntilIdle (void);

  Time GetDelayUntilIdle (void);

/**

100

   * Return the time the last RX start.

101

102

   * \return the time the last RX start.

103

*/

  Time GetLastRxStartTime (void) const;

104

  Time GetLastRxStartTime (void) const;

105

106

/**

107

   * Switch state to TX for the given duration.

108

109

   * \param txDuration the duration of the TX

110

   * \param packet the packet

111

   * \param txMode the transmission mode of the packet

112

   * \param preamble the preamble of the packet

113

   * \param txPower the transmission power

114

*/

  void SwitchToTx (Time txDuration, Ptr<const Packet> packet, WifiMode txMode, WifiPreamble preamble, uint8_t txPower);

115

  void SwitchToTx (Time txDuration, Ptr<const Packet> packet, WifiMode txMode, WifiPreamble preamble, uint8_t txPower);

116

/**

117

   * Switch state to RX for the given duration.

118

119

   * \param rxDuration the duration of the RX

120

*/

  void SwitchToRx (Time rxDuration);

121

  void SwitchToRx (Time rxDuration);

122

/**

123

   * Switch state to channel switching for the given duration.

124

125

   * \param switchingDuration the duration of required to switch the channel

126

*/

  void SwitchToChannelSwitching (Time switchingDuration);

127

  void SwitchToChannelSwitching (Time switchingDuration);

128

/**

129

   * Switch from RX after the reception was successful.

130

131

   * \param packet the successfully received packet

132

   * \param snr the SNR of the received packet

133

   * \param mode the transmission mode of the packet

134

   * \param preamble the preamble of the received packet

135

*/

  void SwitchFromRxEndOk (Ptr<Packet> packet, double snr, WifiMode mode, enum WifiPreamble preamble);

136

  void SwitchFromRxEndOk (Ptr<Packet> packet, double snr, WifiMode mode, enum WifiPreamble preamble);

137

/**

138

   * Switch from RX after the reception failed.

139

140

   * \param packet the packet that we failed to received

141

   * \param snr the SNR of the received packet

142

*/

  void SwitchFromRxEndError (Ptr<const Packet> packet, double snr);

143

  void SwitchFromRxEndError (Ptr<const Packet> packet, double snr);

144

/**

145

   * Switch to CCA busy.

146

147

   * \param duration the duration of CCA busy state

148

*/

  void SwitchMaybeToCcaBusy (Time duration);

149

  void SwitchMaybeToCcaBusy (Time duration);

150

  TracedCallback<Time,Time,enum WifiPhy::State> m_stateLogger;

151

  TracedCallback<Time,Time,enum WifiPhy::State> m_stateLogger;

Lines 66-78	Link Here

154

  void LogPreviousIdleAndCcaBusyStates (void);

155

  void LogPreviousIdleAndCcaBusyStates (void);

156

157

/**

158

   * Notify all WifiPhyListener that the transmission has started for the given duration.

159

160

   * \param duration the duration of the transmission

161

*/

  void NotifyTxStart (Time duration);

162

  void NotifyTxStart (Time duration);

  void NotifyWakeup (void);

163

  void NotifyWakeup (void);

164

/**

165

   * Notify all WifiPhyListener that the reception has started for the given duration.

166

167

   * \param duration the duration of the reception

168

*/

  void NotifyRxStart (Time duration);

169

  void NotifyRxStart (Time duration);

170

/**

171

   * Notify all WifiPhyListener that the reception was successful.

172

*/

  void NotifyRxEndOk (void);

173

  void NotifyRxEndOk (void);

174

/**

175

   * Notify all WifiPhyListener that the reception was not successful.

176

*/

  void NotifyRxEndError (void);

177

  void NotifyRxEndError (void);

178

/**

179

   * Notify all WifiPhyListener that the CCA has started for the given duration.

180

181

   * \param duration the duration of the CCA state

182

*/

  void NotifyMaybeCcaBusyStart (Time duration);

183

  void NotifyMaybeCcaBusyStart (Time duration);

184

/**

185

   * Notify all WifiPhyListener that we are switching channel with the given channel

186

   * switching delay.

187

188

   * \param duration the delay to switch the channel

189

*/

  void NotifySwitchingStart (Time duration);

190

  void NotifySwitchingStart (Time duration);

191

/**

192

   * Switch the state from RX.

193

*/

  void DoSwitchFromRx (void);

194

  void DoSwitchFromRx (void);

195

  bool m_rxing;

196

  bool m_rxing;

(-)a/src/wifi/model/wifi-phy.h (-2 / +344 lines)

Lines 400-406	Link Here

400

401

   * This was introduced with 11n

401

   * This was introduced with 11n

402

403

   * \param Mcs index in array of supported Mcs

403

   * \param mcs index in array of supported Mcs

404

   * \return the Mcs index whose index is specified.

404

   * \return the Mcs index whose index is specified.

405

406

   * \sa WifiPhy::GetNMcs()

406

   * \sa WifiPhy::GetNMcs()

Lines 445-518	Link Here

445

*/

445

*/

446

  virtual Ptr<WifiChannel> GetChannel (void) const = 0;

446

  virtual Ptr<WifiChannel> GetChannel (void) const = 0;

447

448

/**

449

   * Return a WifiMode for DSSS at 1Mbps.

450

451

   * \return a WifiMode for DSSS at 1Mbps

452

*/

448

  static WifiMode GetDsssRate1Mbps ();

453

  static WifiMode GetDsssRate1Mbps ();

454

/**

455

   * Return a WifiMode for DSSS at 2Mbps.

456

457

   * \return a WifiMode for DSSS at 2Mbps

458

*/

449

  static WifiMode GetDsssRate2Mbps ();

459

  static WifiMode GetDsssRate2Mbps ();

460

/**

461

   * Return a WifiMode for DSSS at 5.5Mbps.

462

463

   * \return a WifiMode for DSSS at 5.5Mbps

464

*/

450

  static WifiMode GetDsssRate5_5Mbps ();

465

  static WifiMode GetDsssRate5_5Mbps ();

466

/**

467

   * Return a WifiMode for DSSS at 11Mbps.

468

469

   * \return a WifiMode for DSSS at 11Mbps

470

*/

451

  static WifiMode GetDsssRate11Mbps ();

471

  static WifiMode GetDsssRate11Mbps ();

472

/**

473

   * Return a WifiMode for ERP-ODFM at 6Mbps.

474

475

   * \return a WifiMode for ERP-OFDM at 6Mbps

476

*/

452

  static WifiMode GetErpOfdmRate6Mbps ();

477

  static WifiMode GetErpOfdmRate6Mbps ();

478

/**

479

   * Return a WifiMode for ERP-ODFM at 9Mbps.

480

481

   * \return a WifiMode for ERP-OFDM at 9Mbps

482

*/

453

  static WifiMode GetErpOfdmRate9Mbps ();

483

  static WifiMode GetErpOfdmRate9Mbps ();

484

/**

485

   * Return a WifiMode for ERP-ODFM at 12Mbps.

486

487

   * \return a WifiMode for ERP-OFDM at 12Mbps

488

*/

454

  static WifiMode GetErpOfdmRate12Mbps ();

489

  static WifiMode GetErpOfdmRate12Mbps ();

490

/**

491

   * Return a WifiMode for ERP-ODFM at 18Mbps.

492

493

   * \return a WifiMode for ERP-OFDM at 18Mbps

494

*/

455

  static WifiMode GetErpOfdmRate18Mbps ();

495

  static WifiMode GetErpOfdmRate18Mbps ();

496

/**

497

   * Return a WifiMode for ERP-ODFM at 24Mbps.

498

499

   * \return a WifiMode for ERP-OFDM at 24Mbps

500

*/

456

  static WifiMode GetErpOfdmRate24Mbps ();

501

  static WifiMode GetErpOfdmRate24Mbps ();

502

/**

503

   * Return a WifiMode for ERP-ODFM at 36Mbps.

504

505

   * \return a WifiMode for ERP-OFDM at 36Mbps

506

*/

457

  static WifiMode GetErpOfdmRate36Mbps ();

507

  static WifiMode GetErpOfdmRate36Mbps ();

508

/**

509

   * Return a WifiMode for ERP-ODFM at 48Mbps.

510

511

   * \return a WifiMode for ERP-OFDM at 48Mbps

512

*/

458

  static WifiMode GetErpOfdmRate48Mbps ();

513

  static WifiMode GetErpOfdmRate48Mbps ();

514

/**

515

   * Return a WifiMode for ERP-ODFM at 54Mbps.

516

517

   * \return a WifiMode for ERP-OFDM at 54Mbps

518

*/

459

  static WifiMode GetErpOfdmRate54Mbps ();

519

  static WifiMode GetErpOfdmRate54Mbps ();

520

/**

521

   * Return a WifiMode for ODFM at 6Mbps.

522

523

   * \return a WifiMode for OFDM at 6Mbps

524

*/

460

  static WifiMode GetOfdmRate6Mbps ();

525

  static WifiMode GetOfdmRate6Mbps ();

526

/**

527

   * Return a WifiMode for ODFM at 9Mbps.

528

529

   * \return a WifiMode for OFDM at 9Mbps

530

*/

461

  static WifiMode GetOfdmRate9Mbps ();

531

  static WifiMode GetOfdmRate9Mbps ();

532

/**

533

   * Return a WifiMode for ODFM at 12Mbps.

534

535

   * \return a WifiMode for OFDM at 12Mbps

536

*/

462

  static WifiMode GetOfdmRate12Mbps ();

537

  static WifiMode GetOfdmRate12Mbps ();

538

/**

539

   * Return a WifiMode for ODFM at 18Mbps.

540

541

   * \return a WifiMode for OFDM at 18Mbps

542

*/

463

  static WifiMode GetOfdmRate18Mbps ();

543

  static WifiMode GetOfdmRate18Mbps ();

544

/**

545

   * Return a WifiMode for ODFM at 24Mbps.

546

547

   * \return a WifiMode for OFDM at 24Mbps

548

*/

464

  static WifiMode GetOfdmRate24Mbps ();

549

  static WifiMode GetOfdmRate24Mbps ();

550

/**

551

   * Return a WifiMode for ODFM at 36Mbps.

552

553

   * \return a WifiMode for OFDM at 36Mbps

554

*/

465

  static WifiMode GetOfdmRate36Mbps ();

555

  static WifiMode GetOfdmRate36Mbps ();

556

/**

557

   * Return a WifiMode for ODFM at 48Mbps.

558

559

   * \return a WifiMode for OFDM at 48Mbps

560

*/

466

  static WifiMode GetOfdmRate48Mbps ();

561

  static WifiMode GetOfdmRate48Mbps ();

562

/**

563

   * Return a WifiMode for ODFM at 54Mbps.

564

565

   * \return a WifiMode for OFDM at 54Mbps

566

*/

467

  static WifiMode GetOfdmRate54Mbps ();

567

  static WifiMode GetOfdmRate54Mbps ();

568

/**

569

   * Return a WifiMode for ODFM at 3Mbps with 10MHz channel spacing.

570

571

   * \return a WifiMode for OFDM at 3Mbps with 10MHz channel spacing

572

*/

468

  static WifiMode GetOfdmRate3MbpsBW10MHz ();

573

  static WifiMode GetOfdmRate3MbpsBW10MHz ();

574

/**

575

   * Return a WifiMode for ODFM at 4.5Mbps with 10MHz channel spacing.

576

577

   * \return a WifiMode for OFDM at 4.5Mbps with 10MHz channel spacing

578

*/

469

  static WifiMode GetOfdmRate4_5MbpsBW10MHz ();

579

  static WifiMode GetOfdmRate4_5MbpsBW10MHz ();

580

/**

581

   * Return a WifiMode for ODFM at 6Mbps with 10MHz channel spacing.

582

583

   * \return a WifiMode for OFDM at 6Mbps with 10MHz channel spacing

584

*/

470

  static WifiMode GetOfdmRate6MbpsBW10MHz ();

585

  static WifiMode GetOfdmRate6MbpsBW10MHz ();

586

/**

587

   * Return a WifiMode for ODFM at 9Mbps with 10MHz channel spacing.

588

589

   * \return a WifiMode for OFDM at 9Mbps with 10MHz channel spacing

590

*/

471

  static WifiMode GetOfdmRate9MbpsBW10MHz ();

591

  static WifiMode GetOfdmRate9MbpsBW10MHz ();

592

/**

593

   * Return a WifiMode for ODFM at 12Mbps with 10MHz channel spacing.

594

595

   * \return a WifiMode for OFDM at 12Mbps with 10MHz channel spacing

596

*/

472

  static WifiMode GetOfdmRate12MbpsBW10MHz ();

597

  static WifiMode GetOfdmRate12MbpsBW10MHz ();

598

/**

599

   * Return a WifiMode for ODFM at 18Mbps with 10MHz channel spacing.

600

601

   * \return a WifiMode for OFDM at 18Mbps with 10MHz channel spacing

602

*/

473

  static WifiMode GetOfdmRate18MbpsBW10MHz ();

603

  static WifiMode GetOfdmRate18MbpsBW10MHz ();

604

/**

605

   * Return a WifiMode for ODFM at 24Mbps with 10MHz channel spacing.

606

607

   * \return a WifiMode for OFDM at 24Mbps with 10MHz channel spacing

608

*/

474

  static WifiMode GetOfdmRate24MbpsBW10MHz ();

609

  static WifiMode GetOfdmRate24MbpsBW10MHz ();

610

/**

611

   * Return a WifiMode for ODFM at 27Mbps with 10MHz channel spacing.

612

613

   * \return a WifiMode for OFDM at 27Mbps with 10MHz channel spacing

614

*/

475

  static WifiMode GetOfdmRate27MbpsBW10MHz ();

615

  static WifiMode GetOfdmRate27MbpsBW10MHz ();

616

/**

617

   * Return a WifiMode for ODFM at 1.5Mbps with 5MHz channel spacing.

618

619

   * \return a WifiMode for OFDM at 1.5Mbps with 5MHz channel spacing

620

*/

476

  static WifiMode GetOfdmRate1_5MbpsBW5MHz ();

621

  static WifiMode GetOfdmRate1_5MbpsBW5MHz ();

622

/**

623

   * Return a WifiMode for ODFM at 2.25Mbps with 5MHz channel spacing.

624

625

   * \return a WifiMode for OFDM at 2.25Mbps with 5MHz channel spacing

626

*/

477

  static WifiMode GetOfdmRate2_25MbpsBW5MHz ();

627

  static WifiMode GetOfdmRate2_25MbpsBW5MHz ();

628

/**

629

   * Return a WifiMode for ODFM at 3Mbps with 5MHz channel spacing.

630

631

   * \return a WifiMode for OFDM at 3Mbps with 5MHz channel spacing

632

*/

478

  static WifiMode GetOfdmRate3MbpsBW5MHz ();

633

  static WifiMode GetOfdmRate3MbpsBW5MHz ();

634

/**

635

   * Return a WifiMode for ODFM at 4.5Mbps with 5MHz channel spacing.

636

637

   * \return a WifiMode for OFDM at 4.5Mbps with 5MHz channel spacing

638

*/

479

  static WifiMode GetOfdmRate4_5MbpsBW5MHz ();

639

  static WifiMode GetOfdmRate4_5MbpsBW5MHz ();

640

/**

641

   * Return a WifiMode for ODFM at 6Mbps with 5MHz channel spacing.

642

643

   * \return a WifiMode for OFDM at 6Mbps with 5MHz channel spacing

644

*/

480

  static WifiMode GetOfdmRate6MbpsBW5MHz ();

645

  static WifiMode GetOfdmRate6MbpsBW5MHz ();

646

/**

647

   * Return a WifiMode for ODFM at 9Mbps with 5MHz channel spacing.

648

649

   * \return a WifiMode for OFDM at 9Mbps with 5MHz channel spacing

650

*/

481

  static WifiMode GetOfdmRate9MbpsBW5MHz ();

651

  static WifiMode GetOfdmRate9MbpsBW5MHz ();

652

/**

653

   * Return a WifiMode for ODFM at 12Mbps with 5MHz channel spacing.

654

655

   * \return a WifiMode for OFDM at 12Mbps with 5MHz channel spacing

656

*/

482

  static WifiMode GetOfdmRate12MbpsBW5MHz ();

657

  static WifiMode GetOfdmRate12MbpsBW5MHz ();

658

/**

659

   * Return a WifiMode for ODFM at 13.5Mbps with 5MHz channel spacing.

660

661

   * \return a WifiMode for OFDM at 13.5Mbps with 5MHz channel spacing

662

*/

483

  static WifiMode GetOfdmRate13_5MbpsBW5MHz ();

663

  static WifiMode GetOfdmRate13_5MbpsBW5MHz ();

664

/**

665

   * Return a WifiMode for ODFM at 6.5Mbps with 20MHz channel spacing.

666

667

   * \return a WifiMode for OFDM at 6.5Mbps with 20MHz channel spacing

668

*/

484

  static WifiMode GetOfdmRate6_5MbpsBW20MHz ();

669

  static WifiMode GetOfdmRate6_5MbpsBW20MHz ();

670

/**

671

   * Return a WifiMode for ODFM at 13Mbps with 20MHz channel spacing.

672

673

   * \return a WifiMode for OFDM at 13Mbps with 20MHz channel spacing

674

*/

485

  static WifiMode GetOfdmRate13MbpsBW20MHz ();

675

  static WifiMode GetOfdmRate13MbpsBW20MHz ();

676

/**

677

   * Return a WifiMode for ODFM at 19.5Mbps with 20MHz channel spacing.

678

679

   * \return a WifiMode for OFDM at 19.5Mbps with 20MHz channel spacing

680

*/

486

  static WifiMode GetOfdmRate19_5MbpsBW20MHz ();

681

  static WifiMode GetOfdmRate19_5MbpsBW20MHz ();

682

/**

683

   * Return a WifiMode for ODFM at 26Mbps with 20MHz channel spacing.

684

685

   * \return a WifiMode for OFDM at 26Mbps with 20MHz channel spacing

686

*/

487

  static WifiMode GetOfdmRate26MbpsBW20MHz ();

687

  static WifiMode GetOfdmRate26MbpsBW20MHz ();

688

/**

689

   * Return a WifiMode for ODFM at 39Mbps with 20MHz channel spacing.

690

691

   * \return a WifiMode for OFDM at 39Mbps with 20MHz channel spacing

692

*/

488

  static WifiMode GetOfdmRate39MbpsBW20MHz ();

693

  static WifiMode GetOfdmRate39MbpsBW20MHz ();

694

/**

695

   * Return a WifiMode for ODFM at 52Mbps with 20MHz channel spacing.

696

697

   * \return a WifiMode for OFDM at 52Mbps with 20MHz channel spacing

698

*/

489

  static WifiMode GetOfdmRate52MbpsBW20MHz ();

699

  static WifiMode GetOfdmRate52MbpsBW20MHz ();

700

/**

701

   * Return a WifiMode for ODFM at 58.5Mbps with 20MHz channel spacing.

702

703

   * \return a WifiMode for OFDM at 58.5Mbps with 20MHz channel spacing

704

*/

490

  static WifiMode GetOfdmRate58_5MbpsBW20MHz ();

705

  static WifiMode GetOfdmRate58_5MbpsBW20MHz ();

706

/**

707

   * Return a WifiMode for ODFM at 65Mbps with 20MHz channel spacing.

708

709

   * \return a WifiMode for OFDM at 65Mbps with 20MHz channel spacing

710

*/

491

  static WifiMode GetOfdmRate65MbpsBW20MHz ();

711

  static WifiMode GetOfdmRate65MbpsBW20MHz ();

712

/**

713

   * Return a WifiMode for ODFM at 13.5Mbps with 40MHz channel spacing.

714

715

   * \return a WifiMode for OFDM at 13.5Mbps with 40MHz channel spacing

716

*/

492

  static WifiMode GetOfdmRate13_5MbpsBW40MHz ();

717

  static WifiMode GetOfdmRate13_5MbpsBW40MHz ();

493

  static WifiMode GetOfdmRate27MbpsBW40MHz ();

718

/**

719

   * Return a WifiMode for ODFM at 27Mbps with 40MHz channel spacing.

720

721

   * \return a WifiMode for OFDM at 27Mbps with 40MHz channel spacing

722

*/

723

  static WifiMode GetOfdmRate27MbpsBW40MHz ();

724

/**

725

   * Return a WifiMode for ODFM at 40.5Mbps with 40MHz channel spacing.

726

727

   * \return a WifiMode for OFDM at 40.5Mbps with 40MHz channel spacing

728

*/

494

  static WifiMode GetOfdmRate40_5MbpsBW40MHz ();

729

  static WifiMode GetOfdmRate40_5MbpsBW40MHz ();

730

/**

731

   * Return a WifiMode for ODFM at 54Mbps with 40MHz channel spacing.

732

733

   * \return a WifiMode for OFDM at 54Mbps with 40MHz channel spacing

734

*/

495

  static WifiMode GetOfdmRate54MbpsBW40MHz ();

735

  static WifiMode GetOfdmRate54MbpsBW40MHz ();

736

/**

737

   * Return a WifiMode for ODFM at 81Mbps with 40MHz channel spacing.

738

739

   * \return a WifiMode for OFDM at 81Mbps with 40MHz channel spacing

740

*/

496

  static WifiMode GetOfdmRate81MbpsBW40MHz ();

741

  static WifiMode GetOfdmRate81MbpsBW40MHz ();

742

/**

743

   * Return a WifiMode for ODFM at 108Mbps with 40MHz channel spacing.

744

745

   * \return a WifiMode for OFDM at 108Mbps with 40MHz channel spacing

746

*/

497

  static WifiMode GetOfdmRate108MbpsBW40MHz ();

747

  static WifiMode GetOfdmRate108MbpsBW40MHz ();

748

/**

749

   * Return a WifiMode for ODFM at 121.5Mbps with 40MHz channel spacing.

750

751

   * \return a WifiMode for OFDM at 121.5Mbps with 40MHz channel spacing

752

*/

498

  static WifiMode GetOfdmRate121_5MbpsBW40MHz ();

753

  static WifiMode GetOfdmRate121_5MbpsBW40MHz ();

754

/**

755

   * Return a WifiMode for ODFM at 135Mbps with 40MHz channel spacing.

756

757

   * \return a WifiMode for OFDM at 135Mbps with 40MHz channel spacing

758

*/

499

  static WifiMode GetOfdmRate135MbpsBW40MHz ();

759

  static WifiMode GetOfdmRate135MbpsBW40MHz ();

500

  //Rates for clause 20 with short guard interval

760

  //Rates for clause 20 with short guard interval

761

/**

762

   * Return a WifiMode for ODFM at 7.2Mbps with 20MHz channel spacing.

763

764

   * \return a WifiMode for OFDM at 7.2Mbps with 20MHz channel spacing

765

*/

501

  static WifiMode GetOfdmRate7_2MbpsBW20MHz ();

766

  static WifiMode GetOfdmRate7_2MbpsBW20MHz ();

767

/**

768

   * Return a WifiMode for ODFM at 14.4Mbps with 20MHz channel spacing.

769

770

   * \return a WifiMode for OFDM at 14.4Mbps with 20MHz channel spacing

771

*/

502

  static WifiMode GetOfdmRate14_4MbpsBW20MHz ();

772

  static WifiMode GetOfdmRate14_4MbpsBW20MHz ();

773

/**

774

   * Return a WifiMode for ODFM at 21.7Mbps with 20MHz channel spacing.

775

776

   * \return a WifiMode for OFDM at 21.7Mbps with 20MHz channel spacing

777

*/

503

  static WifiMode GetOfdmRate21_7MbpsBW20MHz ();

778

  static WifiMode GetOfdmRate21_7MbpsBW20MHz ();

779

/**

780

   * Return a WifiMode for ODFM at 28.9Mbps with 20MHz channel spacing.

781

782

   * \return a WifiMode for OFDM at 28.9Mbps with 20MHz channel spacing

783

*/

504

  static WifiMode GetOfdmRate28_9MbpsBW20MHz ();

784

  static WifiMode GetOfdmRate28_9MbpsBW20MHz ();

785

/**

786

   * Return a WifiMode for ODFM at 43.3Mbps with 20MHz channel spacing.

787

788

   * \return a WifiMode for OFDM at 43.3Mbps with 20MHz channel spacing

789

*/

505

  static WifiMode GetOfdmRate43_3MbpsBW20MHz ();

790

  static WifiMode GetOfdmRate43_3MbpsBW20MHz ();

791

/**

792

   * Return a WifiMode for ODFM at 57.8Mbps with 20MHz channel spacing.

793

794

   * \return a WifiMode for OFDM at 57.8Mbps with 20MHz channel spacing

795

*/

506

  static WifiMode GetOfdmRate57_8MbpsBW20MHz ();

796

  static WifiMode GetOfdmRate57_8MbpsBW20MHz ();

797

/**

798

   * Return a WifiMode for ODFM at 65Mbps with 20MHz channel spacing.

799

   * The rate supports short guard interval.

800

801

   * \return a WifiMode for OFDM at 65Mbps with 20MHz channel spacing

802

*/

507

  static WifiMode GetOfdmRate65MbpsBW20MHzShGi ();

803

  static WifiMode GetOfdmRate65MbpsBW20MHzShGi ();

804

/**

805

   * Return a WifiMode for ODFM at 72.2Mbps with 20MHz channel spacing.

806

807

   * \return a WifiMode for OFDM at 72.2Mbps with 20MHz channel spacing

808

*/

508

  static WifiMode GetOfdmRate72_2MbpsBW20MHz ();

809

  static WifiMode GetOfdmRate72_2MbpsBW20MHz ();

810

/**

811

   * Return a WifiMode for ODFM at 15Mbps with 40MHz channel spacing.

812

813

   * \return a WifiMode for OFDM at 15Mbps with 40MHz channel spacing

814

*/

509

  static WifiMode GetOfdmRate15MbpsBW40MHz ();

815

  static WifiMode GetOfdmRate15MbpsBW40MHz ();

816

/**

817

   * Return a WifiMode for ODFM at 30Mbps with 40MHz channel spacing.

818

819

   * \return a WifiMode for OFDM at 30Mbps with 40MHz channel spacing

820

*/

510

  static WifiMode GetOfdmRate30MbpsBW40MHz ();

821

  static WifiMode GetOfdmRate30MbpsBW40MHz ();

822

/**

823

   * Return a WifiMode for ODFM at 45Mbps with 40MHz channel spacing.

824

825

   * \return a WifiMode for OFDM at 45Mbps with 40MHz channel spacing

826

*/

511

  static WifiMode GetOfdmRate45MbpsBW40MHz ();

827

  static WifiMode GetOfdmRate45MbpsBW40MHz ();

828

/**

829

   * Return a WifiMode for ODFM at 60Mbps with 40MHz channel spacing.

830

831

   * \return a WifiMode for OFDM at 60Mbps with 40MHz channel spacing

832

*/

512

  static WifiMode GetOfdmRate60MbpsBW40MHz ();

833

  static WifiMode GetOfdmRate60MbpsBW40MHz ();

834

/**

835

   * Return a WifiMode for ODFM at 90Mbps with 40MHz channel spacing.

836

837

   * \return a WifiMode for OFDM at 90Mbps with 40MHz channel spacing

838

*/

513

  static WifiMode GetOfdmRate90MbpsBW40MHz ();

839

  static WifiMode GetOfdmRate90MbpsBW40MHz ();

840

/**

841

   * Return a WifiMode for ODFM at 120Mbps with 40MHz channel spacing.

842

843

   * \return a WifiMode for OFDM at 120Mbps with 40MHz channel spacing

844

*/

514

  static WifiMode GetOfdmRate120MbpsBW40MHz ();

845

  static WifiMode GetOfdmRate120MbpsBW40MHz ();

846

/**

847

   * Return a WifiMode for ODFM at 135Mbps with 40MHz channel spacing.

848

   * The rate supports short guard interval.

849

850

   * \return a WifiMode for OFDM at 135Mbps with 40MHz channel spacing

851

*/

515

  static WifiMode GetOfdmRate135MbpsBW40MHzShGi ();

852

  static WifiMode GetOfdmRate135MbpsBW40MHzShGi ();

853

/**

854

   * Return a WifiMode for ODFM at 150Mbps with 40MHz channel spacing.

855

856

   * \return a WifiMode for OFDM at 150Mbps with 40MHz channel spacing

857

*/

516

  static WifiMode GetOfdmRate150MbpsBW40MHz ();

858

  static WifiMode GetOfdmRate150MbpsBW40MHz ();

517

859

518

860




  /**
   * Sets the maximum STA short retry count (SSRC).
   *
   * \param maxSsrc the maximum SSRC
   */
  void SetMaxSsrc (uint32_t maxSsrc);
  /**
   * Sets the maximum STA long retry count (SLRC).
   *
   * \param maxSlrc the maximum SLRC
   */
  void SetMaxSlrc (uint32_t maxSlrc);
  /**
   * Sets the RTS threshold.
   *
   * \param threshold the RTS threshold
   */
  void SetRtsCtsThreshold (uint32_t threshold);
  /**

   */
  void SetFragmentationThreshold (uint32_t threshold);
  /**
   * Records HT capabilities of the remote station.
   *
   * \param from the address of the station being recorded
   * \param htcapabilities the HT capabilities of the station

   *          false otherwise
   */
  bool GetGreenfieldSupported (Mac48Address address) const;
  /**
   * Add a given Modulation and Coding Scheme (MCS) index to
   * the set of basic MCS.
   *
   * \param mcs the MCS index
   */
  void AddBasicMcs (uint8_t mcs);

  /**
   * Return the default Modulation and Coding Scheme (MCS) index.
   *
   * \return the default MCS index
   */
  uint8_t GetDefaultMcs (void) const;
  /**
   * Return the number of basic MCS index.
   *
   * \return the number of basic MCS index
   */
  uint32_t GetNBasicMcs (void) const;
  /**
   * Return the MCS at the given <i>list</i> index.
   *
   * \param i the position in the list
   * \return the MCS at the given list index
   */
  uint8_t GetBasicMcs (uint32_t i) const;
  /**
   * Record the MCS index supported by the station.
   * 
   * \param address the address of the station
   * \param mcs the MCS index
   */
  void AddSupportedMcs (Mac48Address address, uint8_t mcs);

  /**

  /**
   * Since CTS-to-self parameters are not dependent on the station,
   * it is implemented in wifiremote station manager
   *
   * \return the transmission mode to use to send the CTS-to-self prior to the
   *          transmission of the data packet itself.
   */
  WifiTxVector DoGetCtsToSelfTxVector (void);


  /**
   * Return if we need to do Cts-to-self before sending a DATA.
   *
   * \param txVector the TXVECTOR of the packet to be sent
   * \return true if Cts-to-self is needed, false otherwise
   */
  bool NeedCtsToSelf (WifiTxVector txVector);

  /**
   * Set the default transmission power level
   *
   * \param txPower the default transmission power level
   */
  void SetDefaultTxPowerLevel (uint8_t txPower);
 /**

   * \return the number of modes supported by the given station
   */
  uint32_t GetNSupported (const WifiRemoteStation *station) const;
  /**
   * Return the MCS index supported by the specified station at the specified index.
   *
   * \param station the station being queried
   * \param i the index
   * \return the MCS index at the given index of the specified station
   */
  uint8_t GetMcsSupported (const WifiRemoteStation *station, uint32_t i) const;
  /**
   * Return the number of MCS supported by the given station.
   *
   * \param station the station being queried
   * \return the number of MCS supported by the given station
   */
  uint32_t GetNMcsSupported (const WifiRemoteStation *station) const;

  /**

   *          false otherwise
   */
  bool GetShortGuardInterval (const WifiRemoteStation *station) const;
  /**
   * Return whether the given station supports space-time block coding (STBC).
   *
   * \param station the station being queried
   * \return true if the station supports STBC, false otherwise
   */
  bool GetStbc (const WifiRemoteStation *station) const;
  /**
   * Return whether the station supports Greenfield or not.

  uint32_t GetShortRetryCount (const WifiRemoteStation *station) const;
private:
  /**
   * \param station the station that we need to communicate
   * \param packet the packet to send
   * \param normally indicates whether the normal 802.11 rts enable mechanism would
   *        request that the rts is sent or not.

  virtual bool DoNeedRts (WifiRemoteStation *station,
                          Ptr<const Packet> packet, bool normally);
  /**
   * \param station the station that we need to communicate
   * \param packet the packet to send
   * \param normally indicates whether the normal 802.11 rts enable mechanism would
   *        request that the rts is retransmitted or not.

  virtual bool DoNeedRtsRetransmission (WifiRemoteStation *station,
                                        Ptr<const Packet> packet, bool normally);
  /**
   * \param station the station that we need to communicate
   * \param packet the packet to send
   * \param normally indicates whether the normal 802.11 data retransmission mechanism
   *        would request that the data is retransmitted or not.

                                         Ptr<const Packet> packet, bool normally);

  /**
   * \param station the station that we need to communicate
   * \param packet the packet to send
   * \param normally indicates whether the normal 802.11 data fragmentation mechanism
   *        would request that the data packet is fragmented or not.

   */
  virtual WifiRemoteStation* DoCreateStation (void) const = 0;
 /**
   * \param station the station that we need to communicate
   * \param size size of the packet or fragment we want to send
   * \return the transmission mode to use to send a packet to the station
   *

  virtual WifiTxVector DoGetDataTxVector (WifiRemoteStation *station,
                                  uint32_t size) = 0;
  /**
   * \param station the station that we need to communicate
   * \return the transmission mode to use to send an rts to the station
   *
   * Note: This method is called before sending an rts to a station

   * This method is a pure virtual method that must be implemented by the sub-class.
   * This allows different types of WifiRemoteStationManager to respond differently,
   *
   * \param station the station that we failed to send RTS
   */
  virtual void DoReportRtsFailed (WifiRemoteStation *station) = 0;
  /**
   * This method is a pure virtual method that must be implemented by the sub-class.
   * This allows different types of WifiRemoteStationManager to respond differently,
   *
   * \param station the station that we failed to send DATA
   */
  virtual void DoReportDataFailed (WifiRemoteStation *station) = 0;
  /**
   * This method is a pure virtual method that must be implemented by the sub-class.
   * This allows different types of WifiRemoteStationManager to respond differently,
   *
   * \param station the station that we successfully sent RTS
   * \param ctsSnr the SNR of the CTS we received
   * \param ctsMode the WifiMode the receiver used to send the CTS
   * \param rtsSnr the SNR of the RTS we sent

   * This method is a pure virtual method that must be implemented by the sub-class.
   * This allows different types of WifiRemoteStationManager to respond differently,
   *
   * \param station the station that we successfully sent RTS
   * \param ackSnr the SNR of the ACK we received
   * \param ackMode the WifiMode the receiver used to send the ACK
   * \param dataSnr the SNR of the DATA we sent

   * This method is a pure virtual method that must be implemented by the sub-class.
   * This allows different types of WifiRemoteStationManager to respond differently,
   *
   * \param station the station that we failed to send RTS
   */
  virtual void DoReportFinalRtsFailed (WifiRemoteStation *station) = 0;
  /**
   * This method is a pure virtual method that must be implemented by the sub-class.
   * This allows different types of WifiRemoteStationManager to respond differently,
   *
   * \param station the station that we failed to send DATA
   */
  virtual void DoReportFinalDataFailed (WifiRemoteStation *station) = 0;
  /**

(-)a/src/wifi/model/wifi-tx-vector.h (-6 / +20 lines)

Lines 53-60	Link Here

   *  \returns the txvector payload mode

   *  \returns the txvector payload mode

*/

*/

  WifiMode GetMode (void) const;

  WifiMode GetMode (void) const;

/**

/**

  * Sets the selected payload transmission mode

  * Sets the selected payload transmission mode

  * \param mode

*/

*/

  void SetMode (WifiMode mode);

  void SetMode (WifiMode mode);

/**

/**

Lines 63-76	Link Here

  uint8_t GetTxPowerLevel (void) const;

  uint8_t GetTxPowerLevel (void) const;

/**

/**

   * Sets the selected transmission power level

   * Sets the selected transmission power level

   * \param powerlevel

*/

*/

  void SetTxPowerLevel (uint8_t powerlevel);

  void SetTxPowerLevel (uint8_t powerlevel);

/**

/**

   *  \returns the number of retries

   *  \returns the number of retries

*/

*/

  uint8_t GetRetries (void) const;

  uint8_t GetRetries (void) const;

/**

/**

   * Sets the number of retries

   * Sets the number of retries

   * \param retries

*/

*/

  void SetRetries (uint8_t retries);

  void SetRetries (uint8_t retries);

/**

/**

Lines 79-100	Link Here

  bool IsShortGuardInterval (void) const;

  bool IsShortGuardInterval (void) const;

/**

/**

   * Sets if short gurad interval is being used

   * Sets if short gurad interval is being used

   * \param guardinterval enable or disable short guard interval

*/

*/

  void SetShortGuardInterval (bool guardinterval);

  void SetShortGuardInterval (bool guardinterval);

/**

/**

   *  \returns the number of Nss

   *  \returns the number of Nss

*/

*/

  uint8_t GetNss (void) const;

  uint8_t GetNss (void) const;

/**

/**

   * Sets the number of Nss refer to IEEE802.11n Table 20-28 for explanation and range

   * Sets the number of Nss refer to IEEE802.11n Table 20-28 for explanation and range

   * \param nss

*/

100

*/

  void SetNss (uint8_t nss);

101

  void SetNss (uint8_t nss);

/**

102

/**

   *  \returns the number of Ness

103

   *  \returns the number of Ness

*/

104

*/

  uint8_t GetNess (void) const;

105

  uint8_t GetNess (void) const;

/**

106

/**

   * Sets the Ness number refer to IEEE802.11n Table 20-6 for explanation

107

   * Sets the Ness number refer to IEEE802.11n Table 20-6 for explanation

108

109

   * \param ness

*/

110

*/

  void SetNess (uint8_t ness);

111

  void SetNess (uint8_t ness);

100

/**

112

/**

Lines 103-110	Link Here

103

  bool IsStbc (void) const;

115

  bool IsStbc (void) const;

104

/**

116

/**

105

   * Sets if STBC is being used

117

   * Sets if STBC is being used

118

119

   * \param stbc enable or disable STBC

106

*/

120

*/

107

  void SetStbc (bool stbcsatuts);

121

  void SetStbc (bool stbc);

108

122

109

123

110

private:

124

private:

(-)a/src/wifi/model/yans-error-rate-model.h (+35 lines)

Lines 103-114	Link Here

103

   * \return a Binomial distribution

103

   * \return a Binomial distribution

104

*/

104

*/

105

  double Binomial (uint32_t k, double p, uint32_t n) const;

105

  double Binomial (uint32_t k, double p, uint32_t n) const;

106

/**

107

   * \param ber

108

   * \param d

109

   * \return double

110

*/

106

  double CalculatePdOdd (double ber, unsigned int d) const;

111

  double CalculatePdOdd (double ber, unsigned int d) const;

112

/**

113

   * \param ber

114

   * \param d

115

   * \return double

116

*/

107

  double CalculatePdEven (double ber, unsigned int d) const;

117

  double CalculatePdEven (double ber, unsigned int d) const;

118

/**

119

   * \param ber

120

   * \param d

121

   * \return double

122

*/

108

  double CalculatePd (double ber, unsigned int d) const;

123

  double CalculatePd (double ber, unsigned int d) const;

124

/**

125

   * \param snr

126

   * \param nbits

127

   * \param signalSpread

128

   * \param phyRate

129

   * \param dFree

130

   * \param adFree

131

   * \return double

132

*/

109

  double GetFecBpskBer (double snr, double nbits,

133

  double GetFecBpskBer (double snr, double nbits,

110

                        uint32_t signalSpread, uint32_t phyRate,

134

                        uint32_t signalSpread, uint32_t phyRate,

111

                        uint32_t dFree, uint32_t adFree) const;

135

                        uint32_t dFree, uint32_t adFree) const;

136

/**

137

   * \param snr

138

   * \param nbits

139

   * \param signalSpread

140

   * \param phyRate

141

   * \param m

142

   * \param dfree

143

   * \param adFree

144

   * \param adFreePlusOne

145

   * \return double

146

*/

112

  double GetFecQamBer (double snr, uint32_t nbits,

147

  double GetFecQamBer (double snr, uint32_t nbits,

113

                       uint32_t signalSpread,

148

                       uint32_t signalSpread,

114

                       uint32_t phyRate,

149

                       uint32_t phyRate,

(-)a/src/wifi/model/yans-wifi-phy.h (-1 / +98 lines)

Lines 69-77	Link Here

  YansWifiPhy ();

  YansWifiPhy ();

  virtual ~YansWifiPhy ();

  virtual ~YansWifiPhy ();

/**

   * Set the YansWifiChannel this YansWifiPhy is to be connected to.

   * \param channel the YansWifiChannel this YansWifiPhy is to be connected to

*/

  void SetChannel (Ptr<YansWifiChannel> channel);

  void SetChannel (Ptr<YansWifiChannel> channel);

/**

   * Set the current channel number.

   * \param id the channel number

*/

  void SetChannelNumber (uint16_t id);

  void SetChannelNumber (uint16_t id);

/**

   * Return the current channel number.

   * \return the current channel number

*/

  uint16_t GetChannelNumber () const;

  uint16_t GetChannelNumber () const;

/**

/**

   * Return current center channel frequency in MHz.

   * Return current center channel frequency in MHz.

Lines 80-85	Link Here

*/

*/

  double GetChannelFrequencyMhz () const;

  double GetChannelFrequencyMhz () const;

/**

   * Starting receiving the packet (i.e. the first bit of the preamble has arrived).

100

101

   * \param packet the arriving packet

102

   * \param rxPowerDbm the receive power in dBm

103

   * \param txVector the TXVECTOR of the arriving packet

104

   * \param preamble the preamble of the arriving packet

105

*/

  void StartReceivePacket (Ptr<Packet> packet,

106

  void StartReceivePacket (Ptr<Packet> packet,

                           double rxPowerDbm,

107

                           double rxPowerDbm,

                           WifiTxVector txVector,

108

                           WifiTxVector txVector,

Lines 206-212	Link Here

206

*/

229

*/

207

  Ptr<Object> GetMobility (void);

230

  Ptr<Object> GetMobility (void);

208

231

232

/**

233

   * Return the minimum available transmission power level (dBm).

234

   * \return the minimum available transmission power level (dBm)

235

*/

209

  virtual double GetTxPowerStart (void) const;

236

  virtual double GetTxPowerStart (void) const;

237

/**

238

   * Return the maximum available transmission power level (dBm).

239

   * \return the maximum available transmission power level (dBm)

240

*/

210

  virtual double GetTxPowerEnd (void) const;

241

  virtual double GetTxPowerEnd (void) const;

211

/**

242

/**

212

   * Return the number of available transmission power levels.

243

   * Return the number of available transmission power levels.

Lines 321-327	Link Here

321

/**

352

/**

322

   * Enable or disable channel bonding support.

353

   * Enable or disable channel bonding support.

323

354

324

   * \param channelBonding Enable or disable channel bonding

355

   * \param channelbonding Enable or disable channel bonding

325

*/

356

*/

326

  virtual void SetChannelBonding (bool channelbonding) ;

357

  virtual void SetChannelBonding (bool channelbonding) ;

327

358

Lines 353-371	Link Here

353

private:

384

private:

354

  YansWifiPhy (const YansWifiPhy &o);

385

  YansWifiPhy (const YansWifiPhy &o);

355

  virtual void DoDispose (void);

386

  virtual void DoDispose (void);

387

/**

388

   * Configure YansWifiPhy with appropriate channel frequency and

389

   * supported rates for 802.11a standard.

390

*/

356

  void Configure80211a (void);

391

  void Configure80211a (void);

392

/**

393

   * Configure YansWifiPhy with appropriate channel frequency and

394

   * supported rates for 802.11b standard.

395

*/

357

  void Configure80211b (void);

396

  void Configure80211b (void);

397

/**

398

   * Configure YansWifiPhy with appropriate channel frequency and

399

   * supported rates for 802.11g standard.

400

*/

358

  void Configure80211g (void);

401

  void Configure80211g (void);

402

/**

403

   * Configure YansWifiPhy with appropriate channel frequency and

404

   * supported rates for 802.11a standard with 10MHz channel spacing.

405

*/

359

  void Configure80211_10Mhz (void);

406

  void Configure80211_10Mhz (void);

407

/**

408

   * Configure YansWifiPhy with appropriate channel frequency and

409

   * supported rates for 802.11a standard with 5MHz channel spacing.

410

*/

360

  void Configure80211_5Mhz ();

411

  void Configure80211_5Mhz ();

361

  void ConfigureHolland (void);

412

  void ConfigureHolland (void);

413

/**

414

   * Configure YansWifiPhy with appropriate channel frequency and

415

   * supported rates for 802.11n standard.

416

*/

362

  void Configure80211n (void);

417

  void Configure80211n (void);

418

/**

419

   * Return the energy detection threshold.

420

421

   * \return the energy detection threshold.

422

*/

363

  double GetEdThresholdW (void) const;

423

  double GetEdThresholdW (void) const;

424

/**

425

   * Convert from dBm to Watts.

426

427

   * \param dbm the power in dBm

428

   * \return the equivalent Watts for the given dBm

429

*/

364

  double DbmToW (double dbm) const;

430

  double DbmToW (double dbm) const;

431

/**

432

   * Convert from dB to ratio.

433

434

   * \param db

435

   * \return ratio

436

*/

365

  double DbToRatio (double db) const;

437

  double DbToRatio (double db) const;

438

/**

439

   * Convert from Watts to dBm.

440

441

   * \param w the power in Watts

442

   * \return the equivalent dBm for the given Watts

443

*/

366

  double WToDbm (double w) const;

444

  double WToDbm (double w) const;

445

/**

446

   * Convert from ratio to dB.

447

448

   * \param ratio

449

   * \return dB

450

*/

367

  double RatioToDb (double ratio) const;

451

  double RatioToDb (double ratio) const;

452

/**

453

   * Get the power of the given power level in dBm.

454

   * In YansWifiPhy implementation, the power levels are equally spaced (in dBm).

455

456

   * \param power the power level

457

   * \return the transmission power in dBm at the given power level

458

*/

368

  double GetPowerDbm (uint8_t power) const;

459

  double GetPowerDbm (uint8_t power) const;

460

/**

461

   * The last bit of the packet has arrived.

462

463

   * \param packet the packet that the last bit has arrived

464

   * \param event the corresponding event of the first time the packet arrives

465

*/

369

  void EndReceive (Ptr<Packet> packet, Ptr<InterferenceHelper::Event> event);

466

  void EndReceive (Ptr<Packet> packet, Ptr<InterferenceHelper::Event> event);

370

467

371

private:

468

private:

Return to bug 938