Attachment #1717 for bug #938

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

(-)a/src/wifi/model/ap-wifi-mac.h (-1 / +70 lines)

Lines 88-94	Link Here

*/

*/

  void SetBeaconInterval (Time interval);

  void SetBeaconInterval (Time interval);

/**

/**

   * \returns the interval between two beacon transmissions.

   * \return the interval between two beacon transmissions.

*/

*/

  Time GetBeaconInterval (void) const;

  Time GetBeaconInterval (void) const;

/**

/**

Lines 108-114	Link Here

108

109

private:

109

private:

110

  virtual void Receive (Ptr<Packet> packet, const WifiMacHeader *hdr);

110

  virtual void Receive (Ptr<Packet> packet, const WifiMacHeader *hdr);

111

/**

112

   * The packet we sent was successfully received by the receiver

113

   * (i.e. we received an ACK from the receiver).  If the packet

114

   * was an association response to the receiver, we record that

115

   * the receiver is now associated with us.

116

117

   * \param hdr the header of the packet that we successfully sent

118

*/

111

  virtual void TxOk (const WifiMacHeader &hdr);

119

  virtual void TxOk (const WifiMacHeader &hdr);

120

/**

121

   * The packet we sent was successfully received by the receiver

122

   * (i.e. we did not receive an ACK from the receiver).  If the packet

123

   * was an association response to the receiver, we record that

124

   * the receiver is not associated with us yet.

125

126

   * \param hdr the header of the packet that we failed to sent

127

*/

112

  virtual void TxFailed (const WifiMacHeader &hdr);

128

  virtual void TxFailed (const WifiMacHeader &hdr);

113

129

114

/**

130

/**

Lines 123-136	Link Here

123

  virtual void DeaggregateAmsduAndForward (Ptr<Packet> aggregatedPacket,

139

  virtual void DeaggregateAmsduAndForward (Ptr<Packet> aggregatedPacket,

124

                                           const WifiMacHeader *hdr);

140

                                           const WifiMacHeader *hdr);

125

141

142

/**

143

   * Forward the packet down to DCF/EDCAF (enqueue the packet). This method

144

   * is a wrapper for ForwardDown with traffic id.

145

146

   * \param packet the packet we are forwarding to DCF/EDCAF

147

   * \param from the address to be used for Address 3 field in the header

148

   * \param to the address to be used for Address 1 field in the header

149

*/

126

  void ForwardDown (Ptr<const Packet> packet, Mac48Address from, Mac48Address to);

150

  void ForwardDown (Ptr<const Packet> packet, Mac48Address from, Mac48Address to);

151

/**

152

   * Forward the packet down to DCF/EDCAF (enqueue the packet).

153

154

   * \param packet the packet we are forwarding to DCF/EDCAF

155

   * \param from the address to be used for Address 3 field in the header

156

   * \param to the address to be used for Address 1 field in the header

157

   * \param tid the traffic id for the packet

158

*/

127

  void ForwardDown (Ptr<const Packet> packet, Mac48Address from, Mac48Address to, uint8_t tid);

159

  void ForwardDown (Ptr<const Packet> packet, Mac48Address from, Mac48Address to, uint8_t tid);

160

/**

161

   * Forward a probe response packet to the DCF. The standard is not clear on the correct

162

   * queue for management frames if QoS is supported. We always use the DCF.

163

164

   * \param to the address of the STA we are sending a probe response to

165

*/

128

  void SendProbeResp (Mac48Address to);

166

  void SendProbeResp (Mac48Address to);

167

/**

168

   * Forward an association response packet to the DCF. The standard is not clear on the correct

169

   * queue for management frames if QoS is supported. We always use the DCF.

170

171

   * \param to the address of the STA we are sending an association response to

172

   * \param success indicates whether the association was successful or not

173

*/

129

  void SendAssocResp (Mac48Address to, bool success);

174

  void SendAssocResp (Mac48Address to, bool success);

175

/**

176

   * Forward a beacon packet to the beacon special DCF.

177

*/

130

  void SendOneBeacon (void);

178

  void SendOneBeacon (void);

179

/**

180

   * Return the HT capability of the current AP.

181

182

   * \return the HT capability that we support

183

*/

131

  HtCapabilities GetHtCapabilities (void) const;

184

  HtCapabilities GetHtCapabilities (void) const;

185

/**

186

   * Return an instance of SupportedRates that contains all rates that we support

187

   * including HT rates.

188

189

   * \return SupportedRates all rates that we support

190

*/

132

  SupportedRates GetSupportedRates (void) const;

191

  SupportedRates GetSupportedRates (void) const;

192

/**

193

   * Enable or disable beacon generation of the AP.

194

195

   * \param enable enable or disable beacon generation

196

*/

133

  void SetBeaconGeneration (bool enable);

197

  void SetBeaconGeneration (bool enable);

198

/**

199

   * Return whether the AP is generating beacons.

200

201

   * \return true if beacons are periodically generated, false otherwise

202

*/

134

  bool GetBeaconGeneration (void) const;

203

  bool GetBeaconGeneration (void) const;

135

  virtual void DoDispose (void);

204

  virtual void DoDispose (void);

136

  virtual void DoInitialize (void);

205

  virtual void DoInitialize (void);

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

Lines 67-76	Link Here

class DsssErrorRateModel

class DsssErrorRateModel

public:

public:

/**

   * A function DQPSK

   * \param x x

   * \return DQPSK(x)

*/

  static double DqpskFunction (double x);

  static double DqpskFunction (double x);

/**

   * Return the chunk success rate of the differential BPSK.

   * \param sinr the SINR of the chunk

   * \param nbits the size of the chunk

   * \return the chunk success rate of the differential BPSK

*/

  static double GetDsssDbpskSuccessRate (double sinr, uint32_t nbits);

  static double GetDsssDbpskSuccessRate (double sinr, uint32_t nbits);

/**

   * Return the chunk success rate of the differential encoded QPSK.

   * \param sinr the SINR of the chunk

   * \param nbits the size of the chunk

   * \return the chunk success rate of the differential encoded QPSK.

*/

  static double GetDsssDqpskSuccessRate (double sinr,uint32_t nbits);

  static double GetDsssDqpskSuccessRate (double sinr,uint32_t nbits);

/**

   * Return the chunk success rate of the differential encoded QPSK for

   * 5.5Mbps data rate.

   * \param sinr the SINR of the chunk

   * \param nbits the size of the chunk

   * \return the chunk success rate of the differential encoded QPSK for

100

*/

  static double GetDsssDqpskCck5_5SuccessRate (double sinr,uint32_t nbits);

101

  static double GetDsssDqpskCck5_5SuccessRate (double sinr,uint32_t nbits);

102

/**

103

   * Return the chunk success rate of the differential encoded QPSK for

104

   * 11Mbps data rate.

105

106

   * \param sinr the SINR of the chunk

107

   * \param nbits the size of the chunk

108

   * \return the chunk success rate of the differential encoded QPSK for

109

*/

  static double GetDsssDqpskCck11SuccessRate (double sinr,uint32_t nbits);

110

  static double GetDsssDqpskCck11SuccessRate (double sinr,uint32_t nbits);

#ifdef ENABLE_GSL

111

#ifdef ENABLE_GSL

  static double SymbolErrorProb16Cck (double e2);  /// equation (18) in Pursley's paper

112

  static double SymbolErrorProb16Cck (double e2);  /// equation (18) in Pursley's paper




   */
  double CalculateSnr (WifiMode txMode, double ber) const;

  /**
   * A pure virtual method that must be implemented in the subclass.
   * This method returns the probability that the given 'chuck' of the
   * packet will be successfully received by the PHY.
   *
   * A chuck can be viewed as a part of a packet with equal SNR.
   * The probability of successfully receiving the chunk depends on
   * the mode, the SNR, and the size of the chunk.
   *
   * \param mode the Wi-Fi mode the chunk is sent
   * \param snr the SNR of the chunk
   * \param nbits the number of bits in this chunk
   */
  virtual double GetChunkSuccessRate (WifiMode mode, double snr, uint32_t nbits) const = 0;
};


(-)a/src/wifi/model/ideal-wifi-manager.h (-3 / +18 lines)

Lines 68-78	Link Here

  virtual WifiTxVector DoGetRtsTxVector (WifiRemoteStation *station);

  virtual WifiTxVector DoGetRtsTxVector (WifiRemoteStation *station);

  virtual bool IsLowLatency (void) const;

  virtual bool IsLowLatency (void) const;

  // return the min snr needed to successfully transmit

/**

  // data with this mode at the specified ber.

   * Return the minimum SNR needed to successfully transmit

   * data with this mode at the specified BER.

   * \param mode WifiMode

   * \return the minimum SNR for the given mode

*/

  double GetSnrThreshold (WifiMode mode) const;

  double GetSnrThreshold (WifiMode mode) const;

  void AddModeSnrThreshold (WifiMode mode, double ber);

/**

   * Adds a pair of WifiMode and the minimum SNR for that given mode

   * to the list.

   * \param mode WifiMode

   * \param snr the minimum SNR for the given mode

*/

  void AddModeSnrThreshold (WifiMode mode, double snr);

/**

   * A vector of <snr, mode> pair that holds the minimum SNR for different mode

*/

  typedef std::vector<std::pair<double,WifiMode> > Thresholds;

  typedef std::vector<std::pair<double,WifiMode> > Thresholds;

  double m_ber;

  double m_ber;

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

Lines 46-61	Link Here

private:

private:

  double CalculatePe (double p, uint32_t bValue) const;

  double CalculatePe (double p, uint32_t bValue) const;

/**

   * Return BER of BPSK at the given SNR.

   * \param snr snr value

   * \return BER of BPSK at the given SNR

*/

  double GetBpskBer (double snr) const;

  double GetBpskBer (double snr) const;

/**

   * Return BER of QPSK at the given SNR.

   * \param snr snr value

   * \return BER of QPSK at the given SNR

*/

  double GetQpskBer (double snr) const;

  double GetQpskBer (double snr) const;

/**

   * Return BER of QAM16 at the given SNR.

   * \param snr snr value

   * \return BER of QAM16 at the given SNR

*/

  double Get16QamBer (double snr) const;

  double Get16QamBer (double snr) const;

/**

   * Return BER of QAM64 at the given SNR.

   * \param snr snr value

   * \return BER of QAM64 at the given SNR

*/

  double Get64QamBer (double snr) const;

  double Get64QamBer (double snr) const;

/**

   * Return BER of BPSK at the given SNR after applying FEC.

   * \param snr snr value

   * \param nbits the number of bits in the chunk

   * \param bValue

   * \return BER of BPSK at the given SNR after applying FEC

*/

  double GetFecBpskBer (double snr, double nbits,

  double GetFecBpskBer (double snr, double nbits,

                        uint32_t bValue) const;

                        uint32_t bValue) const;

/**

   * Return BER of QPSK at the given SNR after applying FEC.

   * \param snr snr value

   * \param nbits the number of bits in the chunk

   * \param bValue

   * \return BER of QPSK at the given SNR after applying FEC

*/

  double GetFecQpskBer (double snr, double nbits,

  double GetFecQpskBer (double snr, double nbits,

                        uint32_t bValue) const;

                        uint32_t bValue) const;

/**

   * Return BER of QAM16 at the given SNR after applying FEC.

100

   * \param snr snr value

101

   * \param nbits the number of bits in the chunk

102

   * \param bValue

103

   * \return BER of QAM16 at the given SNR after applying FEC

104

*/

  double GetFec16QamBer (double snr, uint32_t nbits,

105

  double GetFec16QamBer (double snr, uint32_t nbits,

                         uint32_t bValue) const;

106

                         uint32_t bValue) const;

107

/**

108

   * Return BER of QAM64 at the given SNR after applying FEC.

109

110

   * \param snr snr value

111

   * \param nbits the number of bits in the chunk

112

   * \param bValue

113

   * \return BER of QAM64 at the given SNR after applying FEC

114

*/

  double GetFec64QamBer (double snr, uint32_t nbits,

115

  double GetFec64QamBer (double snr, uint32_t nbits,

                         uint32_t bValue) const;

116

                         uint32_t bValue) const;

};

117

};

(-)a/src/wifi/model/qos-tag.h (-1 / +8 lines)

Lines 70-76	Link Here

  QosTag ();

  QosTag ();

/**

/**

   * Create a QosTag with the given TID

   * Create a QosTag with the given Traffic ID

   * \param tid the given Traffic ID

*/

*/

  QosTag (uint8_t tid);

  QosTag (uint8_t tid);

Lines 100-105	Link Here

100

  virtual uint32_t GetSerializedSize () const;

102

  virtual uint32_t GetSerializedSize () const;

101

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

103

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

102

104

105

/**

106

   * Return the Type ID.

107

108

   * \return type ID

109

*/

103

  uint8_t GetTid (void) const;

110

  uint8_t GetTid (void) const;

104

111

105

private:

112

private:

(-)a/src/wifi/model/qos-utils.h (-1 / +11 lines)

Lines 52-57	Link Here

 * \ingroup wifi

 * \ingroup wifi

 * Maps TID (Traffic ID) to Access classes.

 * Maps TID (Traffic ID) to Access classes.

 * For more details see table 9-1 of IEEE802.11 standard.

 * For more details see table 9-1 of IEEE802.11 standard.

 * \param tid the Traffic ID to be mapped to Access class

*/

*/

AcIndex QosUtilsMapTidToAc (uint8_t tid);

AcIndex QosUtilsMapTidToAc (uint8_t tid);

Lines 59-64	Link Here

 * \ingroup wifi

 * \ingroup wifi

 * If a qos tag is attached to the packet, returns a value < 8.

 * If a qos tag is attached to the packet, returns a value < 8.

 * A value >= 8 is returned otherwise.

 * A value >= 8 is returned otherwise.

 * \param packet the packet to checked for a QoS tag

 * \return a value less than 8 if QoS tag was present, a value >= 8

 *         is returned if no QoS tag was present

*/

*/

uint8_t QosUtilsGetTidForPacket (Ptr<const Packet> packet);

uint8_t QosUtilsGetTidForPacket (Ptr<const Packet> packet);

Lines 67-72	Link Here

 * Next function is useful to correctly sort buffered packets under block ack.

 * Next function is useful to correctly sort buffered packets under block ack.

 * When an BAR is received from originator station, completed "old"

 * 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.

 * (see section 9.10.3 in IEEE802.11e) packets must be forwarded up before "new" packets.

 * \param seqConrol the sequence control field

 * \param endSequence

*/

*/

uint32_t QosUtilsMapSeqControlToUniqueInteger (uint16_t seqControl, uint16_t endSequence);

uint32_t QosUtilsMapSeqControlToUniqueInteger (uint16_t seqControl, uint16_t endSequence);

Lines 102-108	Link Here

102

 * if that packet (with sequence number <i>numberSeq</i>)) belongs to the section of the

111

 * if that packet (with sequence number <i>numberSeq</i>)) belongs to the section of the

103

 * sequence number space marked with '-' characters. The function returns false otherwise.

112

 * sequence number space marked with '-' characters. The function returns false otherwise.

104

113

105

114

 * \param startingSeq the starting sequence number

115

 * \param seqNumber the sequence number to be checked

106

*/

116

*/

107

bool QosUtilsIsOldPacket (uint16_t startingSeq, uint16_t seqNumber);

117

bool QosUtilsIsOldPacket (uint16_t startingSeq, uint16_t seqNumber);

108

118





  Time GetRifs (void) const;
  /**
   * \return the current PIFS duration.
   */
  Time GetPifs (void) const;
  /**
   * \return the current SIFS duration.
   */
  Time GetSifs (void) const;
  /**
   * \return the current slot duration.
   */
  Time GetSlot (void) const;
  /**
   * \return the current EIFS minus DIFS duration
   */
  Time GetEifsNoDifs (void) const;
  /**
   * \return the current CTS timeout duration.
   */
  Time GetCtsTimeout (void) const;
  /**
   * \return the current ACK timeout duration.
   */
  Time GetAckTimeout (void) const;

  /**
   * Enable or disable CTS-to-self feature.
   *
   * \param enable true if CTS-to-self is to be supported,
   *        false otherwise
   */
  void SetCtsToSelfSupported (bool enable);
 
  /**
   * Return whether the device supports CTS-to-self
   * capability.
   *
   * \return true if CTS-to-self is supported, false otherwise.
   */
  bool GetCtsToSelfSupported () const;
  /**
   * \return the MAC address associated to this MAC layer.
   */
  virtual Mac48Address GetAddress (void) const;
  /**
   * \return the ssid which this MAC layer is going to try to stay in.
   */
  virtual Ssid GetSsid (void) const;
  /**

   */
  virtual void SetBssid (Mac48Address bssid);
  /**
   * \return the bssid of the network this device belongs to.
   */
  virtual Mac48Address GetBssid (void) const;
  /**

   */
  virtual void SetWifiPhy (Ptr<WifiPhy> phy);
  /**
   * \return the physical layer attached to this MAC.
   */
  virtual Ptr<WifiPhy> GetWifiPhy () const;
  /**

   */
  virtual void SetWifiRemoteStationManager (Ptr<WifiRemoteStationManager> stationManager);
  /**
   * \return the station manager attached to this MAC.
   */
  virtual Ptr<WifiRemoteStationManager> GetWifiRemoteStationManager () const;


   * \param hdr a pointer to the MAC header of the received frame.
   */
  virtual void Receive (Ptr<Packet> packet, const WifiMacHeader *hdr);
    /**
   * The packet we sent was successfully received by the receiver
   * (i.e. we received an ACK from the receiver).
   * 
   * \param hdr the header of the packet that we successfully sent
   */
  virtual void TxOk (const WifiMacHeader &hdr);
  /**
   * The packet we sent was successfully received by the receiver
   * (i.e. we did not receive an ACK from the receiver).
   *
   * \param hdr the header of the packet that we failed to sent
   */
  virtual void TxFailed (const WifiMacHeader &hdr);

  /**
   * Forward the packet up to the device.
   *
   * \param packet the packet that we are forwarding up to the device
   * \param from the address of the source
   * \param to the address of the destination
   */
  void ForwardUp (Ptr<Packet> packet, Mac48Address from, Mac48Address to);

  /**

   * however.
   */
  bool m_qosSupported;
  /**
   * Enable or disable QoS support for the device.
   *
   * \param enable whether QoS is supported
   */
  void SetQosSupported (bool enable);
  /** 
   * Return whether the device supports QoS.
   *
   * \return true if QoS is supported, false otherwise
   */
  bool GetQosSupported () const;

 /**

   * however.
   */
  bool m_htSupported;
  /**
   * Enable or disable HT support for the device.
   *
   * \param enable whether HT is supported
   */
  void SetHtSupported (bool enable);
  /**
   * Return whether the device supports QoS.
   *
   * \return true if HT is supported, false otherwise
   */
  bool GetHtSupported () const;

private:

   */
  void SetupEdcaQueue (enum AcIndex ac);

  /**
   * Return the DCF.
   *
   * \return a DCF instance
   */
  Ptr<DcaTxop> GetDcaTxop (void) const;

  /**
   * Return the EDCAF instance for the voice access class.
   *
   * \return a AC_VO EDCAF instance
   */
  Ptr<EdcaTxopN> GetVOQueue (void) const;
  /**
   * Return the EDCAF instance for the video access class.
   *
   * \return a AC_VI EDCAF instance
   */
  Ptr<EdcaTxopN> GetVIQueue (void) const;
  /**
   * Return the EDCAF instance for the best effort access class.
   *
   * \return a AC_BE EDCAF instance
   */
  Ptr<EdcaTxopN> GetBEQueue (void) const;
  /**
   * Return the EDCAF instance for the background access class.
   *
   * \return a AC_BK EDCAF instance
   */
  Ptr<EdcaTxopN> GetBKQueue (void) const;

  TracedCallback<const WifiMacHeader &> m_txOkCallback;

(-)a/src/wifi/model/snr-tag.h (-1 / +7 lines)

Lines 44-49	Link Here

/**

/**

   * Create a SnrTag with the given snr value

   * Create a SnrTag with the given snr value

   * \param snr the given SNR value

*/

*/

  SnrTag(double snr);

  SnrTag(double snr);

Lines 55-63	Link Here

/**

/**

   * Set the SNR to the given value.

   * Set the SNR to the given value.

   * @param snr the value of the snr to set

   * \param snr the value of the snr to set

*/

*/

  void Set (double snr);

  void Set (double snr);

/**

   * Return the SNR value.

   * \return the SNR value

*/

  double Get (void) const;

  double Get (void) const;

private:

private:

  double m_snr;

  double m_snr;

(-)a/src/wifi/model/sta-wifi-mac.h (+68 lines)

Lines 84-89	Link Here

  void StartActiveAssociation (void);

  void StartActiveAssociation (void);

private:

private:

/**

   * The current MAC state of the STA.

*/

  enum MacState

  enum MacState

    ASSOCIATED,

    ASSOCIATED,

Lines 93-113	Link Here

    REFUSED

    REFUSED

};

};

/**

100

   * Enable or disable active probing.

101

102

   * \param enable enable or disable active probing

103

*/

  void SetActiveProbing (bool enable);

104

  void SetActiveProbing (bool enable);

105

/**

106

   * Return whether active probing is enabled.

107

108

   * \return true if active probing is enabled, false otherwise

109

*/

  bool GetActiveProbing (void) const;

110

  bool GetActiveProbing (void) const;

  virtual void Receive (Ptr<Packet> packet, const WifiMacHeader *hdr);

111

  virtual void Receive (Ptr<Packet> packet, const WifiMacHeader *hdr);

112

113

/**

114

   * Forward a probe request packet to the DCF. The standard is not clear on the correct

115

   * queue for management frames if QoS is supported. We always use the DCF.

116

*/

  void SendProbeRequest (void);

117

  void SendProbeRequest (void);

118

/**

119

   * Forward an association request packet to the DCF. The standard is not clear on the correct

120

   * queue for management frames if QoS is supported. We always use the DCF.

121

*/

100

  void SendAssociationRequest (void);

122

  void SendAssociationRequest (void);

123

/**

124

   * Try to ensure that we are associated with an AP by taking an appropriate action

125

   * depending on the current association status.

126

*/

101

  void TryToEnsureAssociated (void);

127

  void TryToEnsureAssociated (void);

128

/**

129

   * This method is called after the association timeout occurred. We switch the state to

130

   * WAIT_ASSOC_RESP and re-send an association request.

131

*/

102

  void AssocRequestTimeout (void);

132

  void AssocRequestTimeout (void);

133

/**

134

   * This method is called after the probe request timeout occurred. We switch the state to

135

   * WAIT_PROBE_RESP and re-send a probe request.

136

*/

103

  void ProbeRequestTimeout (void);

137

  void ProbeRequestTimeout (void);

138

/**

139

   * Return whether we are associated with an AP.

140

141

   * \return true if we are associated with an AP, false otherwise

142

*/

104

  bool IsAssociated (void) const;

143

  bool IsAssociated (void) const;

144

/**

145

   * Return whether we are waiting for an association response from an AP.

146

147

   * \return true if we are waiting for an association response from an AP, false otherwise

148

*/

105

  bool IsWaitAssocResp (void) const;

149

  bool IsWaitAssocResp (void) const;

150

/**

151

   * This method is called after we have not received a beacon from the AP

152

*/

106

  void MissedBeacons (void);

153

  void MissedBeacons (void);

154

/**

155

   * Restarts the beacon timer.

156

157

   * \param delay the delay before the watchdog fires

158

*/

107

  void RestartBeaconWatchdog (Time delay);

159

  void RestartBeaconWatchdog (Time delay);

160

/**

161

   * Return an instance of SupportedRates that contains all rates that we support

162

   * including HT rates.

163

164

   * \return SupportedRates all rates that we support

165

*/

108

  SupportedRates GetSupportedRates (void) const;

166

  SupportedRates GetSupportedRates (void) const;

167

/**

168

   * Set the current MAC state.

169

170

   * \param value the new state

171

*/

109

  void SetState (enum MacState value);

172

  void SetState (enum MacState value);

110

173

174

/**

175

   * Return the HT capability of the current AP.

176

177

   * \return the HT capability that we support

178

*/

111

  HtCapabilities GetHtCapabilities (void) const;

179

  HtCapabilities GetHtCapabilities (void) const;

112

180

113

181

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

Lines 103-143	Link Here

103

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

103

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

104

  virtual uint32_t Deserialize (Buffer::Iterator start);

104

  virtual uint32_t Deserialize (Buffer::Iterator start);

105

106

/**

107

   * Set Type/Subtype values for an association request header.

108

*/

107

  void SetAssocReq (void);

109

  void SetAssocReq (void);

110

/**

111

   * Set Type/Subtype values for an association response header.

112

*/

108

  void SetAssocResp (void);

113

  void SetAssocResp (void);

114

/**

115

   * Set Type/Subtype values for a probe request header.

116

*/

109

  void SetProbeReq (void);

117

  void SetProbeReq (void);

118

/**

119

   * Set Type/Subtype values for a probe response header.

120

*/

110

  void SetProbeResp (void);

121

  void SetProbeResp (void);

122

/**

123

   * Set Type/Subtype values for a beacon header.

124

*/

111

  void SetBeacon (void);

125

  void SetBeacon (void);

126

/**

127

   * Set Type/Subtype values for a data packet with

128

   * no subtype equal to 0.

129

*/

112

  void SetTypeData (void);

130

  void SetTypeData (void);

131

/**

132

   * Set Type/Subtype values for an action header.

133

*/

113

  void SetAction ();

134

  void SetAction ();

135

/**

136

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

137

*/

114

  void SetBlockAckReq (void);

138

  void SetBlockAckReq (void);

139

/**

140

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

141

*/

115

  void SetBlockAck (void);

142

  void SetBlockAck (void);

116

  void SetMultihopAction ();

143

  void SetMultihopAction ();

144

/**

145

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

146

*/

117

  void SetDsFrom (void);

147

  void SetDsFrom (void);

148

/**

149

   * Un-set the From DS bit in the Frame Control field.

150

*/

118

  void SetDsNotFrom (void);

151

  void SetDsNotFrom (void);

152

/**

153

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

154

*/

119

  void SetDsTo (void);

155

  void SetDsTo (void);

156

/**

157

   * Un-set the To DS bit in the Frame Control field.

158

*/

120

  void SetDsNotTo (void);

159

  void SetDsNotTo (void);

160

/**

161

   * Fill the Address 1 field with the given address.

162

163

   * \param address the address to be used in the Address 1 field

164

*/

121

  void SetAddr1 (Mac48Address address);

165

  void SetAddr1 (Mac48Address address);

166

/**

167

   * Fill the Address 2 field with the given address.

168

169

   * \param address the address to be used in the Address 2 field

170

*/

122

  void SetAddr2 (Mac48Address address);

171

  void SetAddr2 (Mac48Address address);

172

/**

173

   * Fill the Address 3 field with the given address.

174

175

   * \param address the address to be used in the Address 3 field

176

*/

123

  void SetAddr3 (Mac48Address address);

177

  void SetAddr3 (Mac48Address address);

178

/**

179

   * Fill the Address 4 field with the given address.

180

181

   * \param address the address to be used in the Address 4 field

182

*/

124

  void SetAddr4 (Mac48Address address);

183

  void SetAddr4 (Mac48Address address);

184

/**

185

   * Set Type/Subtype values with the correct values depending

186

   * on the given type.

187

188

   * \param type the WifiMacType for the header

189

*/

125

  void SetType (enum WifiMacType type);

190

  void SetType (enum WifiMacType type);

191

/**

192

   * Set the Duration/ID field with the given raw uint16_t value.

193

194

   * \param duration the raw duration in uint16_t

195

*/

126

  void SetRawDuration (uint16_t duration);

196

  void SetRawDuration (uint16_t duration);

197

/**

198

   * Set the Duration/ID field with the given duration (Time object).

199

   * The method converts the given time to microseconds.

200

201

   * \param duration the duration (Time object)

202

*/

127

  void SetDuration (Time duration);

203

  void SetDuration (Time duration);

204

/**

205

   * Set the Duration/ID field with the given ID.

206

207

   * \param id the ID

208

*/

128

  void SetId (uint16_t id);

209

  void SetId (uint16_t id);

210

/**

211

   * Set the sequence number of the header.

212

213

   * \param seq the given sequence number

214

*/

129

  void SetSequenceNumber (uint16_t seq);

215

  void SetSequenceNumber (uint16_t seq);

216

/**

217

   * Set the fragment number of the header.

218

219

   * \param frag the given fragment number

220

*/

130

  void SetFragmentNumber (uint8_t frag);

221

  void SetFragmentNumber (uint8_t frag);

222

/**

223

   * Un-set the More Fragment bit in the Frame Control Field

224

*/

131

  void SetNoMoreFragments (void);

225

  void SetNoMoreFragments (void);

226

/**

227

   * Set the More Fragment bit in the Frame Control field

228

*/

132

  void SetMoreFragments (void);

229

  void SetMoreFragments (void);

230

/**

231

   * Set the Retry bit in the Frame Control field.

232

*/

133

  void SetRetry (void);

233

  void SetRetry (void);

234

/**

235

   * Un-set the Retry bit in the Frame Control field.

236

*/

134

  void SetNoRetry (void);

237

  void SetNoRetry (void);

238

/**

239

   * Set the TID for the QoS header.

240

241

   * \param tid the TID for the QoS header

242

*/

135

  void SetQosTid (uint8_t tid);

243

  void SetQosTid (uint8_t tid);

244

/**

245

   * Set the end of service period (EOSP) bit in the QoS control field.

246

*/

136

  void SetQosEosp ();

247

  void SetQosEosp ();

248

/**

249

   * Un-set the end of service period (EOSP) bit in the QoS control field.

250

*/

137

  void SetQosNoEosp ();

251

  void SetQosNoEosp ();

252

/**

253

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

254

*/

138

  void SetQosAckPolicy (enum QosAckPolicy);

255

  void SetQosAckPolicy (enum QosAckPolicy);

256

/**

257

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

258

*/

139

  void SetQosNormalAck (void);

259

  void SetQosNormalAck (void);

260

/**

261

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

262

*/

140

  void SetQosBlockAck (void);

263

  void SetQosBlockAck (void);

264

/**

265

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

266

*/

141

  void SetQosNoAck (void);

267

  void SetQosNoAck (void);

142

  void SetQosAmsdu (void);

268

  void SetQosAmsdu (void);

143

  void SetQosNoAmsdu (void);

269

  void SetQosNoAmsdu (void);

Lines 145-205	Link Here

145

  void SetOrder (void);

271

  void SetOrder (void);

146

  void SetNoOrder (void);

272

  void SetNoOrder (void);

147

273

274

/**

275

   * Return the address in the Address 1 field.

276

277

   * \return the address in the Address 1 field

278

*/

148

  Mac48Address GetAddr1 (void) const;

279

  Mac48Address GetAddr1 (void) const;

280

/**

281

   * Return the address in the Address 2 field.

282

283

   * \return the address in the Address 2 field

284

*/

149

  Mac48Address GetAddr2 (void) const;

285

  Mac48Address GetAddr2 (void) const;

286

/**

287

   * Return the address in the Address 3 field.

288

289

   * \return the address in the Address 3 field

290

*/

150

  Mac48Address GetAddr3 (void) const;

291

  Mac48Address GetAddr3 (void) const;

292

/**

293

   * Return the address in the Address 4 field.

294

295

   * \return the address in the Address 4 field

296

*/

151

  Mac48Address GetAddr4 (void) const;

297

  Mac48Address GetAddr4 (void) const;

298

/**

299

   * Return the type (enum WifiMacType)

300

301

   * \return the type (enum WifiMacType)

302

*/

152

  enum WifiMacType GetType (void) const;

303

  enum WifiMacType GetType (void) const;

304

/**

305

   * \return true if From DS bit is set, false otherwise

306

*/

153

  bool IsFromDs (void) const;

307

  bool IsFromDs (void) const;

308

/**

309

   * \return true if To DS bit is set, false otherwise

310

*/

154

  bool IsToDs (void) const;

311

  bool IsToDs (void) const;

312

/**

313

   * Return true if the Type is DATA.  The method does

314

   * not check the Subtype field. (e.g. the header may be

315

   * DATA with QoS)

316

317

   * \return true if Type is DATA, false otherwise

318

*/

155

  bool IsData (void) const;

319

  bool IsData (void) const;

320

/**

321

   * Return true if the Type is DATA and Subtype is one of the

322

   * possible values for QoS DATA.

323

324

   * \return true if Type is QoS DATA, false otherwise

325

*/

156

  bool IsQosData (void) const;

326

  bool IsQosData (void) const;

327

/**

328

   * Return true if the Type is Control.

329

330

   * \return true if Type is Control, false otherwise

331

*/

157

  bool IsCtl (void) const;

332

  bool IsCtl (void) const;

333

/**

334

   * Return true if the Type is Management.

335

336

   * \return true if Type is Management, false otherwise

337

*/

158

  bool IsMgt (void) const;

338

  bool IsMgt (void) const;

339

/**

340

   * Return true if the Type/Subtype is one of the possible CF-Poll headers.

341

342

   * \return true if the Type/Subtype is one of the possible CF-Poll headers, false otherwise

343

*/

159

  bool IsCfpoll (void) const;

344

  bool IsCfpoll (void) const;

345

/**

346

   * Return true if the header is a RTS header.

347

348

   * \return true if the header is a RTS header, false otherwise

349

*/

160

  bool IsRts (void) const;

350

  bool IsRts (void) const;

351

/**

352

   * Return true if the header is a CTS header.

353

354

   * \return true if the header is a CTS header, false otherwise

355

*/

161

  bool IsCts (void) const;

356

  bool IsCts (void) const;

357

/**

358

   * Return true if the header is an ACK header.

359

360

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

361

*/

162

  bool IsAck (void) const;

362

  bool IsAck (void) const;

363

/**

364

   * Return true if the header is a Block ACK Request header.

365

366

   * \return true if the header is a Block ACK Request header, false otherwise

367

*/

163

  bool IsBlockAckReq (void) const;

368

  bool IsBlockAckReq (void) const;

369

/**

370

   * Return true if the header is a Block ACK header.

371

372

   * \return true if the header is a Block ACK header, false otherwise

373

*/

164

  bool IsBlockAck (void) const;

374

  bool IsBlockAck (void) const;

375

/**

376

   * Return true if the header is an Association Request header.

377

378

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

379

*/

165

  bool IsAssocReq (void) const;

380

  bool IsAssocReq (void) const;

381

/**

382

   * Return true if the header is an Association Response header.

383

384

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

385

*/

166

  bool IsAssocResp (void) const;

386

  bool IsAssocResp (void) const;

387

/**

388

   * Return true if the header is a Reassociation Request header.

389

390

   * \return true if the header is a Reassociation Request header, false otherwise

391

*/

167

  bool IsReassocReq (void) const;

392

  bool IsReassocReq (void) const;

393

/**

394

   * Return true if the header is a Reassociation Response header.

395

396

   * \return true if the header is a Reassociation Response header, false otherwise

397

*/

168

  bool IsReassocResp (void) const;

398

  bool IsReassocResp (void) const;

399

/**

400

   * Return true if the header is a Probe Request header.

401

402

   * \return true if the header is a Probe Request header, false otherwise

403

*/

169

  bool IsProbeReq (void) const;

404

  bool IsProbeReq (void) const;

405

/**

406

   * Return true if the header is a Probe Response header.

407

408

   * \return true if the header is a Probe Response header, false otherwise

409

*/

170

  bool IsProbeResp (void) const;

410

  bool IsProbeResp (void) const;

411

/**

412

   * Return true if the header is a Beacon header.

413

414

   * \return true if the header is a Beacon header, false otherwise

415

*/

171

  bool IsBeacon (void) const;

416

  bool IsBeacon (void) const;

417

/**

418

   * Return true if the header is a Disassociation header.

419

420

   * \return true if the header is a Disassociation header, false otherwise

421

*/

172

  bool IsDisassociation (void) const;

422

  bool IsDisassociation (void) const;

423

/**

424

   * Return true if the header is an Authentication header.

425

426

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

427

*/

173

  bool IsAuthentication (void) const;

428

  bool IsAuthentication (void) const;

429

/**

430

   * Return true if the header is a Deauthentication header.

431

432

   * \return true if the header is a Deauthentication header, false otherwise

433

*/

174

  bool IsDeauthentication (void) const;

434

  bool IsDeauthentication (void) const;

435

/**

436

   * Return true if the header is an Action header.

437

438

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

439

*/

175

  bool IsAction () const;

440

  bool IsAction () const;

176

  bool IsMultihopAction () const;

441

  bool IsMultihopAction () const;

442

/**

443

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

444

445

   * \return the raw duration from the Duration/ID field

446

*/

177

  uint16_t GetRawDuration (void) const;

447

  uint16_t GetRawDuration (void) const;

448

/**

449

   * Return the duration from the Duration/ID field (Time object).

450

451

   * \return the duration from the Duration/ID field (Time object)

452

*/

178

  Time GetDuration (void) const;

453

  Time GetDuration (void) const;

454

/**

455

   * Return the raw Sequence Control field.

456

457

   * \return the raw Sequence Control field

458

*/

179

  uint16_t GetSequenceControl (void) const;

459

  uint16_t GetSequenceControl (void) const;

460

/**

461

   * Return the sequence number of the header.

462

463

   * \return the sequence number of the header

464

*/

180

  uint16_t GetSequenceNumber (void) const;

465

  uint16_t GetSequenceNumber (void) const;

466

/**

467

   * Return the fragment number of the header.

468

469

   * \return the fragment number of the header

470

*/

181

  uint16_t GetFragmentNumber (void) const;

471

  uint16_t GetFragmentNumber (void) const;

472

/**

473

   * Return if the Retry bit is set.

474

475

   * \return true if the Retry bit is set, false otherwise

476

*/

182

  bool IsRetry (void) const;

477

  bool IsRetry (void) const;

478

/**

479

   * Return if the More Fragment bit is set.

480

481

   * \return true if the More Fragment bit is set, false otherwise

482

*/

183

  bool IsMoreFragments (void) const;

483

  bool IsMoreFragments (void) const;

484

/**

485

   * Return if the QoS ACK policy is Block ACK.

486

487

   * \return true if the QoS ACK policy is Block ACK, false otherwise

488

*/

184

  bool IsQosBlockAck (void) const;

489

  bool IsQosBlockAck (void) const;

490

/**

491

   * Return if the QoS ACK policy is No ACK.

492

493

   * \return true if the QoS ACK policy is No ACK, false otherwise

494

*/

185

  bool IsQosNoAck (void) const;

495

  bool IsQosNoAck (void) const;

496

/**

497

   * Return if the QoS ACK policy is Normal ACK.

498

499

   * \return true if the QoS ACK policy is No ACK, false otherwise

500

*/

186

  bool IsQosAck (void) const;

501

  bool IsQosAck (void) const;

502

/**

503

   * Return if the end of service period (EOSP) is set.

504

505

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

506

*/

187

  bool IsQosEosp (void) const;

507

  bool IsQosEosp (void) const;

188

  bool IsQosAmsdu (void) const;

508

  bool IsQosAmsdu (void) const;

509

/**

510

   * Return the Traffic ID of a QoS header.

511

512

   * \return the Traffic ID of a QoS header

513

*/

189

  uint8_t GetQosTid (void) const;

514

  uint8_t GetQosTid (void) const;

515

/**

516

   * Return the QoS ACK Policy of a QoS header.

517

518

   * \return the QoS ACK Policy of a QoS header

519

*/

190

  enum QosAckPolicy GetQosAckPolicy (void) const;

520

  enum QosAckPolicy GetQosAckPolicy (void) const;

191

  uint8_t GetQosTxopLimit (void) const;

521

  uint8_t GetQosTxopLimit (void) const;

192

522

193

  uint32_t GetSize (void) const;

523

  uint32_t GetSize (void) const;

524

/**

525

   * Return a string corresponds to the header type.

526

527

   * \returns a string corresponds to the header type.

528

*/

194

  const char * GetTypeString (void) const;

529

  const char * GetTypeString (void) const;

195

530

196

531

197

private:

532

private:

533

/**

534

   * Return the raw Frame Control field.

535

536

   * \return the raw Frame Control field

537

*/

198

  uint16_t GetFrameControl (void) const;

538

  uint16_t GetFrameControl (void) const;

539

/**

540

   * Return the raw QoS Control field.

541

542

   * \return the raw QoS Control field

543

*/

199

  uint16_t GetQosControl (void) const;

544

  uint16_t GetQosControl (void) const;

545

/**

546

   * Set the Frame Control field with the given raw value.

547

548

   * \param control the raw Frame Control field value

549

*/

200

  void SetFrameControl (uint16_t control);

550

  void SetFrameControl (uint16_t control);

551

/**

552

   * Set the Sequence Control field with the given raw value.

553

554

   * \param seq the raw Sequence Control field value

555

*/

201

  void SetSequenceControl (uint16_t seq);

556

  void SetSequenceControl (uint16_t seq);

557

/**

558

   * Set the QoS Control field with the given raw value.

559

560

   * \param qos the raw QoS Control field value

561

*/

202

  void SetQosControl (uint16_t qos);

562

  void SetQosControl (uint16_t qos);

563

/**

564

   * Print the Frame Control field to the output stream.

565

566

   * \param os the output stream to print to

567

*/

203

  void PrintFrameControl (std::ostream &os) const;

568

  void PrintFrameControl (std::ostream &os) const;

204

569

205

  uint8_t m_ctrlType;

570

  uint8_t m_ctrlType;




   */
  void SetMaxPropagationDelay (Time delay);
/**
   * \return the current RIFS duration.
   */

  virtual Time GetRifs (void) const = 0;

  /**
   * \return the current PIFS duration.
   */
  virtual Time GetPifs (void) const = 0;
  /**
   * \return the current SIFS duration.
   */
  virtual Time GetSifs (void) const = 0;
  /**
   * \return the current slot duration.
   */
  virtual Time GetSlot (void) const = 0;
  /**
   * \return the current EIFS minus DIFS duration
   */
  virtual Time GetEifsNoDifs (void) const = 0;
  /**
   * \return the current CTS timeout duration.
   */
  virtual Time GetCtsTimeout (void) const = 0;
  /**
   * \return the current ACK timeout duration.
   */
  virtual Time GetAckTimeout (void) const = 0;
  /**
   * \return the maximum lifetime of an MSDU.
   *
   * Unused for now.
   */
  Time GetMsduLifetime (void) const;
  /**
   * \return the maximum propagation delay.
   * 
   * Unused for now.
   */
  Time GetMaxPropagationDelay (void) const;

  /**
   * \return the MAC address associated to this MAC layer.
   */
  virtual Mac48Address GetAddress (void) const = 0;
  /**
   * \return the ssid which this MAC layer is going to try to stay in.
   */
  virtual Ssid GetSsid (void) const = 0;
  /**

   */
  virtual void SetSsid (Ssid ssid) = 0;
  /**
   * \return the bssid of the network this device belongs to.
   */
  virtual Mac48Address GetBssid (void) const = 0;
  /**

   * access it granted to this MAC.
   */
  virtual void Enqueue (Ptr<const Packet> packet, Mac48Address to) = 0;
  /**
   * \return if this MAC supports sending from arbitrary address.
   *
   * The interface may or may not support sending from arbitrary address.
   * This function returns true if sending from arbitrary address is supported,
   * false otherwise.
   */
  virtual bool SupportsSendFrom (void) const = 0;
  /**
   * \param phy the physical layer attached to this MAC.

  /* Next functions are not pure virtual so non Qos WifiMacs are not
   * forced to implement them.
   */

  /**
   * \param blockAckTimeout the duration for basic block ACK timeout.
   *
   * Sets the timeout for basic block ACK.
   */
  virtual void SetBasicBlockAckTimeout (Time blockAckTimeout);
  /**
   * \return the current basic block ACK timeout duration.
   */
  virtual Time GetBasicBlockAckTimeout (void) const;
  /**
   * \param blockAckTimeout
   *
   * Sets the timeout for compressed block ACK.
   */
  virtual void SetCompressedBlockAckTimeout (Time blockAckTimeout);
  /**
   * \return the current compressed block ACK timeout duration.
   */
  virtual Time GetCompressedBlockAckTimeout (void) const;

  /**
   * \param packet the packet being enqueued
   *
   * Public method used to fire a MacTx trace.  Implemented for encapsulation
   * purposes.  Note this trace indicates that the packet was accepted by the
   * device only.  The packet may be dropped later (e.g. if the queue is full).
   */
  void NotifyTx (Ptr<const Packet> packet);

  /**
   * \param packet the packet being dropped
   * 
   * Public method used to fire a MacTxDrop trace.  Implemented for encapsulation
   * purposes.  This trace indicates that the packet was dropped before it was
   * transmitted (e.g. when a STA is not associated with an AP).
   */
  void NotifyTxDrop (Ptr<const Packet> packet);

  /**
   * \param packet the packet we received
   * 
   * Public method used to fire a MacRx trace.  Implemented for encapsulation
   * purposes.
   */
  void NotifyRx (Ptr<const Packet> packet);

  /**
   * \param packet the packet we received promiscuously
   *
   * Public method used to fire a MacPromiscRx trace.  Implemented for encapsulation
   * purposes.
   */
  void NotifyPromiscRx (Ptr<const Packet> packet);

  /**
   * \param packet the packet we received but is not destined for us
   * 
   * Public method used to fire a MacRxDrop trace.  Implemented for encapsulation
   * purposes.
   */

  void ConfigureStandard (enum WifiPhyStandard standard);

protected:
  /**
   * \param dcf the DCF to be configured
   * \param cwmin the minimum congestion window for the DCF
   * \param cwmax the maximum congestion window for the DCF
   * \param ac the access category for the DCF
   *
   * Configure the DCF with appropriate values depending on the given access category.
   */
  void ConfigureDcf (Ptr<Dcf> dcf, uint32_t cwmin, uint32_t cwmax, enum AcIndex ac);
private:
  /**
   * \return the default maximum propagation delay
   *
   * By default, we get the maximum propagation delay from 1000 m and speed of light
   * (3e8 m/s).
   */
  static Time GetDefaultMaxPropagationDelay (void);
  /**
   * \return the default slot duration
   * 
   * Return a default slot value for 802.11a (9 microseconds).
   */
  static Time GetDefaultSlot (void);
  /**
   * \return the default short interframe space (SIFS)
   * 
   * Return a default SIFS value for 802.11a (16 microseconds).
   */
  static Time GetDefaultSifs (void);
  /**
   * \return the default reduced interframe space (RIFS)
   * 
   * Return a default RIFS value for 802.11n (2 microseconds).
   */
  static Time GetDefaultRifs (void);
  /**
   * \return the default extended interframe space (EIFS) without
   *          DCF interframe space (DIFS)
   * 
   * Return default SIFS + default CTS-ACK delay
   */
  static Time GetDefaultEifsNoDifs (void);
  /**
   * \return the default CTS-ACK delay
   * 
   * Return a default value for 802.11a at 6Mbps (44 microseconds)
   */
  static Time GetDefaultCtsAckDelay (void);
  /**
   * \return the default CTS and ACK timeout
   * 
   * Return the default CTS and ACK timeout.
   * Cts_Timeout and Ack_Timeout are specified in the Annex C
   * (Formal description of MAC operation, see details on the
   * Trsp timer setting at page 346)
   */
  static Time GetDefaultCtsAckTimeout (void);
  static Time GetDefaultBasicBlockAckDelay (void);
  /**
   * \return the default basic block ACK timeout
   */
  static Time GetDefaultBasicBlockAckTimeout (void);
  static Time GetDefaultCompressedBlockAckDelay (void);
  /**
   * \return the default compressed block ACK timeout
   */
  static Time GetDefaultCompressedBlockAckTimeout (void);
  /**
   * \param standard the phy standard to be used


  Time m_maxPropagationDelay;

  /**
   * Configure appropriate timing parameters for 802.11a.
   */
  void Configure80211a (void);
  /**
   * Configure appropriate timing parameters for 802.11b.
   */
  void Configure80211b (void);
  /**
   * Configure appropriate timing parameters for 802.11g.
   */
  void Configure80211g (void);
  /**
   * Configure appropriate timing parameters for 802.11 with 10Mhz channel spacing.
   */
  void Configure80211_10Mhz (void);
  /**
   * Configure appropriate timing parameters for 802.11 with 5Mhz channel spacing.
   */
  void Configure80211_5Mhz ();
  /**
   * Configure appropriate timing parameters for 802.11n operating at 2.4Ghz.
   */
  void Configure80211n_2_4Ghz (void);
  /**
   * Configure appropriate timing parameters for 802.11n operating at 5Ghz.
   */
  void Configure80211n_5Ghz (void);

  /**




}


// Clause 15 rates (DSSS)
 * Clause 15 rates (DSSS)
 */

WifiMode
WifiPhy::GetDsssRate1Mbps ()

}


// Clause 18 rates (HR/DSSS)

 */
WifiMode
WifiPhy::GetDsssRate5_5Mbps ()
{

}


// Clause 19.5 rates (ERP-OFDM)

 */
WifiMode
WifiPhy::GetErpOfdmRate6Mbps ()
{

}


// Clause 17 rates (OFDM)

 */
WifiMode
WifiPhy::GetOfdmRate6Mbps ()
{

  return mode;
}

// 10 MHz channel rates

WifiMode
WifiPhy::GetOfdmRate3MbpsBW10MHz ()
{

  return mode;
}

// 5 MHz channel rates

WifiMode
WifiPhy::GetOfdmRate1_5MbpsBW5MHz ()
{

  return mode;
}

// Clause 20

WifiMode
WifiPhy::GetOfdmRate6_5MbpsBW20MHz ()

(-)a/src/wifi/model/wifi-phy.h (-53 / +103 lines)

Lines 162-171	Link Here

162

  WifiPhy ();

162

  WifiPhy ();

163

  virtual ~WifiPhy ();

163

  virtual ~WifiPhy ();

164

165

/**

166

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

167

168

   * \return the minimum available transmission power level in dBm

169

*/

165

  virtual double GetTxPowerStart (void) const = 0;

170

  virtual double GetTxPowerStart (void) const = 0;

171

/**

172

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

173

174

   * \return the maximum available transmission power level in dBm

175

*/

166

  virtual double GetTxPowerEnd (void) const = 0;

176

  virtual double GetTxPowerEnd (void) const = 0;

167

/**

177

/**

168

   * \returns the number of tx power levels available for this PHY.

178

   * \return the number of tx power levels available for this PHY.

169

*/

179

*/

170

  virtual uint32_t GetNTxPower (void) const = 0;

180

  virtual uint32_t GetNTxPower (void) const = 0;

171

181

Lines 198-238	Link Here

198

  virtual void RegisterListener (WifiPhyListener *listener) = 0;

208

  virtual void RegisterListener (WifiPhyListener *listener) = 0;

199

209

200

/**

210

/**

201

   * \returns true of the current state of the PHY layer is WifiPhy::IDLE, false otherwise.

211

   * \return true of the current state of the PHY layer is WifiPhy::IDLE, false otherwise.

202

*/

212

*/

203

  virtual bool IsStateIdle (void) = 0;

213

  virtual bool IsStateIdle (void) = 0;

204

/**

214

/**

205

   * \returns true of the current state of the PHY layer is WifiPhy::CCA_BUSY, false otherwise.

215

   * \return true of the current state of the PHY layer is WifiPhy::CCA_BUSY, false otherwise.

206

*/

216

*/

207

  virtual bool IsStateCcaBusy (void) = 0;

217

  virtual bool IsStateCcaBusy (void) = 0;

208

/**

218

/**

209

   * \returns true of the current state of the PHY layer is not WifiPhy::IDLE, false otherwise.

219

   * \return true of the current state of the PHY layer is not WifiPhy::IDLE, false otherwise.

210

*/

220

*/

211

  virtual bool IsStateBusy (void) = 0;

221

  virtual bool IsStateBusy (void) = 0;

212

/**

222

/**

213

   * \returns true of the current state of the PHY layer is WifiPhy::RX, false otherwise.

223

   * \return true of the current state of the PHY layer is WifiPhy::RX, false otherwise.

214

*/

224

*/

215

  virtual bool IsStateRx (void) = 0;

225

  virtual bool IsStateRx (void) = 0;

216

/**

226

/**

217

   * \returns true of the current state of the PHY layer is WifiPhy::TX, false otherwise.

227

   * \return true of the current state of the PHY layer is WifiPhy::TX, false otherwise.

218

*/

228

*/

219

  virtual bool IsStateTx (void) = 0;

229

  virtual bool IsStateTx (void) = 0;

220

/**

230

/**

221

   * \returns true of the current state of the PHY layer is WifiPhy::SWITCHING, false otherwise.

231

   * \return true of the current state of the PHY layer is WifiPhy::SWITCHING, false otherwise.

222

*/

232

*/

223

  virtual bool IsStateSwitching (void) = 0;

233

  virtual bool IsStateSwitching (void) = 0;

224

/**

234

/**

225

   * \returns the amount of time since the current state has started.

235

   * \return the amount of time since the current state has started.

226

*/

236

*/

227

  virtual Time GetStateDuration (void) = 0;

237

  virtual Time GetStateDuration (void) = 0;

228

/**

238

/**

229

   * \returns the predicted delay until this PHY can become WifiPhy::IDLE.

239

   * \return the predicted delay until this PHY can become WifiPhy::IDLE.

230

240

231

   * The PHY will never become WifiPhy::IDLE _before_ the delay returned by

241

   * The PHY will never become WifiPhy::IDLE _before_ the delay returned by

232

   * this method but it could become really idle later.

242

   * this method but it could become really idle later.

233

*/

243

*/

234

  virtual Time GetDelayUntilIdle (void) = 0;

244

  virtual Time GetDelayUntilIdle (void) = 0;

235

245

246

/**

247

   * Return the start time of the last received packet.

248

249

   * \return the start time of the last received packet

250

*/

236

  virtual Time GetLastRxStartTime (void) const = 0;

251

  virtual Time GetLastRxStartTime (void) const = 0;

237

252

238

/**

253

/**

Lines 313-319	Link Here

313

   * WifiRemoteStationManager), which itself is a superset (again, not

328

   * WifiRemoteStationManager), which itself is a superset (again, not

314

   * necessarily proper) of the BSSBasicRateSet.

329

   * necessarily proper) of the BSSBasicRateSet.

315

330

316

   * \returns the number of transmission modes supported by this PHY.

331

   * \return the number of transmission modes supported by this PHY.

317

332

318

   * \sa WifiPhy::GetMode()

333

   * \sa WifiPhy::GetMode()

319

*/

334

*/

Lines 332-338	Link Here

332

   * necessarily proper) of the BSSBasicRateSet.

347

   * necessarily proper) of the BSSBasicRateSet.

333

348

334

   * \param mode index in array of supported modes

349

   * \param mode index in array of supported modes

335

   * \returns the mode whose index is specified.

350

   * \return the mode whose index is specified.

336

351

337

   * \sa WifiPhy::GetNModes()

352

   * \sa WifiPhy::GetNModes()

338

*/

353

*/

Lines 340-346	Link Here

340

/**

355

/**

341

   * \param txMode the transmission mode

356

   * \param txMode the transmission mode

342

   * \param ber the probability of bit error rate

357

   * \param ber the probability of bit error rate

343

   * \returns the minimum snr which is required to achieve

358

   * \return the minimum snr which is required to achieve

344

   *          the requested ber for the specified transmission mode. (W/W)

359

   *          the requested ber for the specified transmission mode. (W/W)

345

*/

360

*/

346

  virtual double CalculateSnr (WifiMode txMode, double ber) const = 0;

361

  virtual double CalculateSnr (WifiMode txMode, double ber) const = 0;

Lines 354-360	Link Here

354

   * This was introduced with 11n

369

   * This was introduced with 11n

355

370

356

   * \param selector index in array of supported memeberships

371

   * \param selector index in array of supported memeberships

357

   * \returns the memebership selector whose index is specified.

372

   * \return the memebership selector whose index is specified.

358

373

359

   * \sa WifiPhy::NBssMembershipSelectors()

374

   * \sa WifiPhy::NBssMembershipSelectors()

360

*/

375

*/

Lines 371-377	Link Here

371

   * This was introduced with 11n

386

   * This was introduced with 11n

372

387

373

   * \param selector index in array of supported memeberships

388

   * \param selector index in array of supported memeberships

374

   * \returns a WifiModeList that contains the WifiModes associrated with the selected index.

389

   * \return a WifiModeList that contains the WifiModes associrated with the selected index.

375

390

376

   * \sa WifiPhy::GetMembershipSelectorModes()

391

   * \sa WifiPhy::GetMembershipSelectorModes()

377

*/

392

*/

Lines 386-392	Link Here

386

   * This was introduced with 11n

401

   * This was introduced with 11n

387

402

388

   * \param Mcs index in array of supported Mcs

403

   * \param Mcs index in array of supported Mcs

389

   * \returns the Mcs index whose index is specified.

404

   * \return the Mcs index whose index is specified.

390

405

391

   * \sa WifiPhy::GetNMcs()

406

   * \sa WifiPhy::GetNMcs()

392

*/

407

*/

Lines 405-417	Link Here

405

420

406

   * where Starting channel frequency is standard-dependent, see SetStandard()

421

   * where Starting channel frequency is standard-dependent, see SetStandard()

407

   * as defined in IEEE 802.11-2007 17.3.8.3.2.

422

   * as defined in IEEE 802.11-2007 17.3.8.3.2.

423

424

   * \param id the channel number

408

*/

425

*/

409

  virtual void SetChannelNumber (uint16_t id) = 0;

426

  virtual void SetChannelNumber (uint16_t id) = 0;

410

  /// Return current channel number, see SetChannelNumber()

427

/**

428

   * Return current channel number.

429

430

   * \return the current channel number

431

*/

411

  virtual uint16_t GetChannelNumber () const = 0;

432

  virtual uint16_t GetChannelNumber () const = 0;

412

433

434

/**

435

   * Configure the PHY-level parameters for different Wi-Fi standard.

436

437

   * \param standard the Wi-Fi standard

438

*/

413

  virtual void ConfigureStandard (enum WifiPhyStandard standard) = 0;

439

  virtual void ConfigureStandard (enum WifiPhyStandard standard) = 0;

414

440

441

/**

442

   * Return the WifiChannel this WifiPhy is connected to.

443

444

   * \return the WifiChannel this WifiPhy is connected to

445

*/

415

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

446

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

416

447

417

  static WifiMode GetDsssRate1Mbps ();

448

  static WifiMode GetDsssRate1Mbps ();

Lines 488-523	Link Here

488

/**

519

/**

489

   * Public method used to fire a PhyTxBegin trace.  Implemented for encapsulation

520

   * Public method used to fire a PhyTxBegin trace.  Implemented for encapsulation

490

   * purposes.

521

   * purposes.

522

523

   * \param packet the packet being transmitted

491

*/

524

*/

492

  void NotifyTxBegin (Ptr<const Packet> packet);

525

  void NotifyTxBegin (Ptr<const Packet> packet);

493

526

494

/**

527

/**

495

   * Public method used to fire a PhyTxEnd trace.  Implemented for encapsulation

528

   * Public method used to fire a PhyTxEnd trace.  Implemented for encapsulation

496

   * purposes.

529

   * purposes.

530

531

   * \param packet the packet that was transmitted

497

*/

532

*/

498

  void NotifyTxEnd (Ptr<const Packet> packet);

533

  void NotifyTxEnd (Ptr<const Packet> packet);

499

534

500

/**

535

/**

501

   * Public method used to fire a PhyTxDrop trace.  Implemented for encapsulation

536

   * Public method used to fire a PhyTxDrop trace.  Implemented for encapsulation

502

   * purposes.

537

   * purposes.

538

539

   * \param packet the packet that was failed to transmitted

503

*/

540

*/

504

  void NotifyTxDrop (Ptr<const Packet> packet);

541

  void NotifyTxDrop (Ptr<const Packet> packet);

505

542

506

/**

543

/**

507

   * Public method used to fire a PhyRxBegin trace.  Implemented for encapsulation

544

   * Public method used to fire a PhyRxBegin trace.  Implemented for encapsulation

508

   * purposes.

545

   * purposes.

546

547

   * \param packet the packet being received

509

*/

548

*/

510

  void NotifyRxBegin (Ptr<const Packet> packet);

549

  void NotifyRxBegin (Ptr<const Packet> packet);

511

550

512

/**

551

/**

513

   * Public method used to fire a PhyRxEnd trace.  Implemented for encapsulation

552

   * Public method used to fire a PhyRxEnd trace.  Implemented for encapsulation

514

   * purposes.

553

   * purposes.

554

555

   * \param packet the packet received

515

*/

556

*/

516

  void NotifyRxEnd (Ptr<const Packet> packet);

557

  void NotifyRxEnd (Ptr<const Packet> packet);

517

558

518

/**

559

/**

519

   * Public method used to fire a PhyRxDrop trace.  Implemented for encapsulation

560

   * Public method used to fire a PhyRxDrop trace.  Implemented for encapsulation

520

   * purposes.

561

   * purposes.

562

563

   * \param packet the packet that was not successfully received

521

*/

564

*/

522

  void NotifyRxDrop (Ptr<const Packet> packet);

565

  void NotifyRxDrop (Ptr<const Packet> packet);

523

566

Lines 526-545	Link Here

526

   * Public method used to fire a MonitorSniffer trace for a wifi packet being received.  Implemented for encapsulation

569

   * Public method used to fire a MonitorSniffer trace for a wifi packet being received.  Implemented for encapsulation

527

   * purposes.

570

   * purposes.

528

571

529

   * @param packet the packet being received

572

   * \param packet the packet being received

530

   * @param channelFreqMhz the frequency in MHz at which the packet is

573

   * \param channelFreqMhz the frequency in MHz at which the packet is

531

   * received. Note that in real devices this is normally the

574

   *        received. Note that in real devices this is normally the

532

   * frequency to which  the receiver is tuned, and this can be

575

   *        frequency to which  the receiver is tuned, and this can be

533

   * different than the frequency at which the packet was originally

576

   *        different than the frequency at which the packet was originally

534

   * transmitted. This is because it is possible to have the receiver

577

   *        transmitted. This is because it is possible to have the receiver

535

   * tuned on a given channel and still to be able to receive packets

578

   *        tuned on a given channel and still to be able to receive packets

536

   * on a nearby channel.

579

   *        on a nearby channel.

537

   * @param channelNumber the channel on which the packet is received

580

   * \param channelNumber the channel on which the packet is received

538

   * @param rate the PHY data rate in units of 500kbps (i.e., the same

581

   * \param rate the PHY data rate in units of 500kbps (i.e., the same

539

   * units used both for the radiotap and for the prism header)

582

   *        units used both for the radiotap and for the prism header)

540

   * @param isShortPreamble true if short preamble is used, false otherwise

583

   * \param isShortPreamble true if short preamble is used, false otherwise

541

   * @param signalDbm signal power in dBm

584

   * \param signalDbm signal power in dBm

542

   * @param noiseDbm  noise power in dBm

585

   * \param noiseDbm  noise power in dBm

543

*/

586

*/

544

  void NotifyMonitorSniffRx (Ptr<const Packet> packet, uint16_t channelFreqMhz, uint16_t channelNumber, uint32_t rate, bool isShortPreamble,

587

  void NotifyMonitorSniffRx (Ptr<const Packet> packet, uint16_t channelFreqMhz, uint16_t channelNumber, uint32_t rate, bool isShortPreamble,

545

                             double signalDbm, double noiseDbm);

588

                             double signalDbm, double noiseDbm);

Lines 549-561	Link Here

549

   * Public method used to fire a MonitorSniffer trace for a wifi packet being transmitted.  Implemented for encapsulation

592

   * Public method used to fire a MonitorSniffer trace for a wifi packet being transmitted.  Implemented for encapsulation

550

   * purposes.

593

   * purposes.

551

594

552

   * @param packet the packet being transmitted

595

   * \param packet the packet being transmitted

553

   * @param channelFreqMhz the frequency in MHz at which the packet is

596

   * \param channelFreqMhz the frequency in MHz at which the packet is

554

   * transmitted.

597

   *        transmitted.

555

   * @param channelNumber the channel on which the packet is transmitted

598

   * \param channelNumber the channel on which the packet is transmitted

556

   * @param rate the PHY data rate in units of 500kbps (i.e., the same

599

   * \param rate the PHY data rate in units of 500kbps (i.e., the same

557

   * units used both for the radiotap and for the prism header)

600

   *        units used both for the radiotap and for the prism header)

558

   * @param isShortPreamble true if short preamble is used, false otherwise

601

   * \param isShortPreamble true if short preamble is used, false otherwise

602

   * \param txPower the transmission power in dBm

559

*/

603

*/

560

  void NotifyMonitorSniffTx (Ptr<const Packet> packet, uint16_t channelFreqMhz, uint16_t channelNumber, uint32_t rate, bool isShortPreamble, uint8_t txPower);

604

  void NotifyMonitorSniffTx (Ptr<const Packet> packet, uint16_t channelFreqMhz, uint16_t channelNumber, uint32_t rate, bool isShortPreamble, uint8_t txPower);

561

605

Lines 570-632	Link Here

570

  virtual int64_t AssignStreams (int64_t stream) = 0;

614

  virtual int64_t AssignStreams (int64_t stream) = 0;

571

615

572

/**

616

/**

573

   * \param the operating frequency on this node.

617

   * \param freq the operating frequency on this node.

574

*/

618

*/

575

  virtual void SetFrequency (uint32_t freq)=0;

619

  virtual void SetFrequency (uint32_t freq)=0;

620

/**

621

   * \return the operating frequency on this node

622

*/

576

  virtual uint32_t GetFrequency (void) const=0;

623

  virtual uint32_t GetFrequency (void) const=0;

577

/**

624

/**

578

   * \param the number of transmitters on this node.

625

   * \param tx the number of transmitters on this node.

579

*/

626

*/

580

  virtual void SetNumberOfTransmitAntennas (uint32_t tx)=0;

627

  virtual void SetNumberOfTransmitAntennas (uint32_t tx)=0;

581

628

629

/**

630

   * \return the number of transmit antenna on this device

631

*/

582

  virtual uint32_t GetNumberOfTransmitAntennas (void) const=0;

632

  virtual uint32_t GetNumberOfTransmitAntennas (void) const=0;

583

/**

633

/**

584

   * \param the number of recievers on this node.

634

   * \param rx the number of recievers on this node.

585

*/

635

*/

586

  virtual void SetNumberOfReceiveAntennas (uint32_t rx)=0 ;

636

  virtual void SetNumberOfReceiveAntennas (uint32_t rx)=0 ;

587

/**

637

/**

588

   * \returns the number of recievers on this node.

638

   * \return the number of recievers on this node.

589

*/

639

*/

590

  virtual uint32_t GetNumberOfReceiveAntennas (void) const=0;

640

  virtual uint32_t GetNumberOfReceiveAntennas (void) const=0;

591

/**

641

/**

592

   * \paramif short guard interval is supported or not

642

   * \param guardInterval Enable or disable short guard interval

593

*/

643

*/

594

   virtual void SetGuardInterval (bool GuardInterval)=0;

644

   virtual void SetGuardInterval (bool guardInterval)=0;

595

/**

645

/**

596

   *  \returns if short guard interval is supported or not

646

   *  \return true if short guard interval is supported, false otherwise

597

*/

647

*/

598

  virtual bool GetGuardInterval (void) const = 0;

648

  virtual bool GetGuardInterval (void) const = 0;

599

/**

649

/**

600

   * \paramif LDPC is supported or not

650

   * \param ldpc Enable or disable LDPC

601

*/

651

*/

602

  virtual void SetLdpc (bool Ldpc)=0;

652

  virtual void SetLdpc (bool ldpc)=0;

603

/**

653

/**

604

   * \returns if LDPC is supported or not

654

   * \return true if LDPC is supported, false otherwise

605

*/

655

*/

606

  virtual bool GetLdpc (void) const=0;

656

  virtual bool GetLdpc (void) const=0;

607

/**

657

/**

608

   * \paramif STBC is supported or not

658

   * \param stbc Enable or disable STBC is supported

609

*/

659

*/

610

  virtual void SetStbc (bool stbc)=0;

660

  virtual void SetStbc (bool stbc)=0;

611

/**

661

/**

612

   *  \returns if STBC is supported or not

662

   *  \return true if STBC is supported, false otherwise

613

*/

663

*/

614

  virtual bool GetStbc (void) const=0;

664

  virtual bool GetStbc (void) const=0;

615

665

616

/**

666

/**

617

   * \paramif GreenField is supported or not

667

   * \param greenfield Enable or disable GreenField

618

*/

668

*/

619

  virtual void SetGreenfield (bool greenfield)=0;

669

  virtual void SetGreenfield (bool greenfield)=0;

620

/**

670

/**

621

   *  \returns if Green field is supported or not

671

   * \return true if Greenfield is supported, false otherwise

622

*/

672

*/

623

  virtual bool GetGreenfield (void) const=0;

673

  virtual bool GetGreenfield (void) const=0;

624

/**

674

/**

625

   * \paramif channel bonding 40 MHz is supported or not

675

   * \return true if channel bonding 40 MHz is supported, false otherwise

626

*/

676

*/

627

  virtual bool GetChannelBonding (void) const = 0;

677

  virtual bool GetChannelBonding (void) const = 0;

628

/**

678

/**

629

   *  \returns if channel bonding is supported or not

679

   *  \param channelbonding Enable or disable channel bonding

630

*/

680

*/

631

  virtual void SetChannelBonding (bool channelbonding) = 0 ;

681

  virtual void SetChannelBonding (bool channelbonding) = 0 ;

632

682

(-)a/src/wifi/model/wifi-remote-station-manager.cc (+10 lines)

Lines 45-50	Link Here

public:

public:

  HighLatencyDataTxVectorTag ();

  HighLatencyDataTxVectorTag ();

  HighLatencyDataTxVectorTag (WifiTxVector dataTxVector);

  HighLatencyDataTxVectorTag (WifiTxVector dataTxVector);

/**

   * \returns the transmission mode to use to send this packet

*/

  WifiTxVector GetDataTxVector (void) const;

  WifiTxVector GetDataTxVector (void) const;

  static TypeId GetTypeId (void);

  static TypeId GetTypeId (void);

Lines 110-115	Link Here

110

public:

113

public:

111

  HighLatencyRtsTxVectorTag ();

114

  HighLatencyRtsTxVectorTag ();

112

  HighLatencyRtsTxVectorTag (WifiTxVector rtsTxVector);

115

  HighLatencyRtsTxVectorTag (WifiTxVector rtsTxVector);

116

/**

117

   * \returns the transmission mode to use to send the RTS prior to the

118

   *          transmission of the data packet itself.

119

*/

113

  WifiTxVector GetRtsTxVector (void) const;

120

  WifiTxVector GetRtsTxVector (void) const;

114

121

115

  static TypeId GetTypeId (void);

122

  static TypeId GetTypeId (void);

Lines 175-180	Link Here

175

public:

182

public:

176

  HighLatencyCtsToSelfTxVectorTag ();

183

  HighLatencyCtsToSelfTxVectorTag ();

177

  HighLatencyCtsToSelfTxVectorTag (WifiTxVector ctsToSelfTxVector);

184

  HighLatencyCtsToSelfTxVectorTag (WifiTxVector ctsToSelfTxVector);

185

/**

186

   * \returns the transmission mode to use for the CTS-to-self.

187

*/

178

  WifiTxVector GetCtsToSelfTxVector (void) const;

188

  WifiTxVector GetCtsToSelfTxVector (void) const;

179

189

180

  static TypeId GetTypeId (void);

190

  static TypeId GetTypeId (void);

(-)a/src/wifi/model/wifi-remote-station-manager.h (-36 / +373 lines)

Lines 57-69	Link Here

  void NotifyTxSuccess (uint32_t retryCounter);

  void NotifyTxSuccess (uint32_t retryCounter);

  /// Updates average frame error rate when final data or RTS has failed.

  /// Updates average frame error rate when final data or RTS has failed.

  void NotifyTxFailed ();

  void NotifyTxFailed ();

  /// Returns frame error rate (probability that frame is corrupted due to transmission error).

  /// Return frame error rate (probability that frame is corrupted due to transmission error).

  double GetFrameErrorRate () const;

  double GetFrameErrorRate () const;

private:

private:

/**

/**

   * \brief Calculate averaging coefficient for frame error rate. Depends on time of the last update.

   * \brief Calculate averaging coefficient for frame error rate. Depends on time of the last update.

   * \attention Calling this method twice gives different results,

   * \attention Calling this method twice gives different results,

   * because it resets time of last update.

   * because it resets time of last update.

   * \return average coefficient for frame error rate

*/

*/

  double CalculateAveragingCoefficient ();

  double CalculateAveragingCoefficient ();

  /// averaging coefficient depends on the memory time

  /// averaging coefficient depends on the memory time

Lines 88-120	Link Here

  WifiRemoteStationManager ();

  WifiRemoteStationManager ();

  virtual ~WifiRemoteStationManager ();

  virtual ~WifiRemoteStationManager ();

/**

   * Set up PHY associated with this device since it is the object that

   * knows the full set of transmit rates that are supported.

   * \param phy the PHY of this device

*/

  virtual void SetupPhy (Ptr<WifiPhy> phy);

  virtual void SetupPhy (Ptr<WifiPhy> phy);

100

101

/**

102

   * Return the maximum STA short retry count (SSRC).

103

104

   * \return the maximum SSRC

105

*/

  uint32_t GetMaxSsrc (void) const;

106

  uint32_t GetMaxSsrc (void) const;

107

/**

108

   * Return the maximum STA long retry count (SLRC).

109

110

   * \return the maximum SLRC

111

*/

  uint32_t GetMaxSlrc (void) const;

112

  uint32_t GetMaxSlrc (void) const;

113

/**

114

   * Return the RTS threshold.

115

116

   * \return the RTS threshold

117

*/

  uint32_t GetRtsCtsThreshold (void) const;

118

  uint32_t GetRtsCtsThreshold (void) const;

119

/**

120

   * Return the fragmentation threshold.

121

122

   * \return the fragmentation threshold

123

*/

  uint32_t GetFragmentationThreshold (void) const;

124

  uint32_t GetFragmentationThreshold (void) const;

125

/**

126

   * Sets the maximum STA short retry count (SSRC).

127

128

   * \param the maximum SSRC

129

*/

  void SetMaxSsrc (uint32_t maxSsrc);

130

  void SetMaxSsrc (uint32_t maxSsrc);

131

/**

132

   * Sets the maximum STA long retry count (SLRC).

133

134

   * \param the maximum SLRC

135

*/

  void SetMaxSlrc (uint32_t maxSlrc);

136

  void SetMaxSlrc (uint32_t maxSlrc);

137

/**

138

   * Sets the RTS threshold.

139

140

   * \param the RTS threshold

141

*/

  void SetRtsCtsThreshold (uint32_t threshold);

142

  void SetRtsCtsThreshold (uint32_t threshold);

143

/**

144

   * Sets a fragmentation threshold. The method calls a private method

145

   * DoSetFragmentationThreshold that checks the validity of the value given.

146

147

   * \param threshold the fragmentation threshold

148

*/

100

  void SetFragmentationThreshold (uint32_t threshold);

149

  void SetFragmentationThreshold (uint32_t threshold);

101

  void AddStationHtCapabilities (Mac48Address from,HtCapabilities     htcapabilities);

150

/**

151

   * Records HT capabilities of remote station.

152

153

   * \param from the address of the station being recorded

154

   * \param htcapabilities the HT capabilities of the station

155

*/

156

  void AddStationHtCapabilities (Mac48Address from, HtCapabilities htcapabilities);

157

/**

158

   * Enable or disable HT capability support.

159

160

   * \param enable enable or disable HT capability support

161

*/

102

  void SetHtSupported (bool enable);

162

  void SetHtSupported (bool enable);

163

/**

164

   * Return whether the device has HT capability support enabled.

165

166

   * \return true if HT capability support is enabled, false otherwise

167

*/

103

  bool HasHtSupported (void) const;

168

  bool HasHtSupported (void) const;

104

169

105

  // Invoked in a STA upon dis-association

170

/**

106

  // or in an AP upon reboot

171

   * Reset the station, invoked in a STA upon dis-association or in an AP upon reboot.

172

*/

107

  void Reset (void);

173

  void Reset (void);

108

  // Invoked in a STA upon association to store

174

/**

109

  // the set of rates which belong to the

175

   * Invoked in a STA upon association to store the set of rates which belong to the

110

  // BSSBasicRateSet of the associated AP

176

   * BSSBasicRateSet of the associated AP and which are supported locally.

111

  // and which are supported locally.

177

   * Invoked in an AP to configure the BSSBasicRateSet.

112

  // Invoked in an AP to configure the BSSBasicRateSet

178

179

   * \param mode the WifiMode to be added to the basic mode set

180

*/

113

  void AddBasicMode (WifiMode mode);

181

  void AddBasicMode (WifiMode mode);

114

182

183

/**

184

   * Return the default transmission mode.

185

186

   * \return WifiMode the default transmission mode

187

*/

115

  WifiMode GetDefaultMode (void) const;

188

  WifiMode GetDefaultMode (void) const;

189

/**

190

   * Return the number of basic modes we support.

191

192

   * \return the number of basic modes we support

193

*/

116

  uint32_t GetNBasicModes (void) const;

194

  uint32_t GetNBasicModes (void) const;

195

/**

196

   * Return a basic mode from the set of basic modes.

197

198

   * \param i index of the basic mode in the basic mode set

199

   * \return the basic mode at the given index

200

*/

117

  WifiMode GetBasicMode (uint32_t i) const;

201

  WifiMode GetBasicMode (uint32_t i) const;

202

/**

203

   * Return whether the station supports Greenfield or not.

204

205

   * \param address the address of the station

206

   * \return true if Greenfield is supported by the station,

207

   *          false otherwise

208

*/

118

  bool GetGreenfieldSupported (Mac48Address address) const;

209

  bool GetGreenfieldSupported (Mac48Address address) const;

119

  void AddBasicMcs (uint8_t mcs);

210

  void AddBasicMcs (uint8_t mcs);

120

211

Lines 123-134	Link Here

123

  uint8_t GetBasicMcs (uint32_t i) const;

214

  uint8_t GetBasicMcs (uint32_t i) const;

124

  void AddSupportedMcs (Mac48Address address, uint8_t mcs);

215

  void AddSupportedMcs (Mac48Address address, uint8_t mcs);

125

216

217

/**

218

   * Return a mode for non-unicast packets.

219

220

   * \return WifiMode for non-unicast packets

221

*/

126

  WifiMode GetNonUnicastMode (void) const;

222

  WifiMode GetNonUnicastMode (void) const;

127

223

128

224

129

/**

225

/**

130

   * Invoked in an AP upon disassociation of a

226

   * Invoked in an AP upon disassociation of a

131

   * specific STA.

227

   * specific STA.

228

229

   * \param address the address of the STA

132

*/

230

*/

133

  void Reset (Mac48Address address);

231

  void Reset (Mac48Address address);

134

/**

232

/**

Lines 137-152	Link Here

137

   * also supported locally.

235

   * also supported locally.

138

   * The set of supported modes includes

236

   * The set of supported modes includes

139

   * the BSSBasicRateSet.

237

   * the BSSBasicRateSet.

238

239

   * \param address the address of the station being recorded

240

   * \param mode the WifiMode supports by the station

140

*/

241

*/

141

  void AddSupportedMode (Mac48Address address, WifiMode mode);

242

  void AddSupportedMode (Mac48Address address, WifiMode mode);

142

  //void  AddBssMembershipParameters(Mac48Address address, uint32_t selector);

243

  //void  AddBssMembershipParameters(Mac48Address address, uint32_t selector);

143

244

245

/**

246

   * Return whether the station state is brand new.

247

248

   * \param address the address of the station

249

   * \return true if the state of the station is brand new,

250

   *          false otherwise

251

*/

144

  bool IsBrandNew (Mac48Address address) const;

252

  bool IsBrandNew (Mac48Address address) const;

253

/**

254

   * Return whether the station associated.

255

256

   * \param address the address of the station

257

   * \return true if the station is associated,

258

   *          false otherwise

259

*/

145

  bool IsAssociated (Mac48Address address) const;

260

  bool IsAssociated (Mac48Address address) const;

261

/**

262

   * Return whether we are waiting for an ACK for

263

   * the association response we sent.

264

265

   * \param address the address of the station

266

   * \return true if the station is associated,

267

   *          false otherwise

268

*/

146

  bool IsWaitAssocTxOk (Mac48Address address) const;

269

  bool IsWaitAssocTxOk (Mac48Address address) const;

270

/**

271

   * Records that we are waiting for an ACK for

272

   * the association response we sent.

273

274

   * \param address the address of the station

275

*/

147

  void RecordWaitAssocTxOk (Mac48Address address);

276

  void RecordWaitAssocTxOk (Mac48Address address);

277

/**

278

   * Records that we got an ACK for

279

   * the association response we sent.

280

281

   * \param address the address of the station

282

*/

148

  void RecordGotAssocTxOk (Mac48Address address);

283

  void RecordGotAssocTxOk (Mac48Address address);

284

/**

285

   * Records that we missed an ACK for

286

   * the association response we sent.

287

288

   * \param address the address of the station

289

*/

149

  void RecordGotAssocTxFailed (Mac48Address address);

290

  void RecordGotAssocTxFailed (Mac48Address address);

291

/**

292

   * Records that the STA was disassociated.

293

294

   * \param address the address of the station

295

*/

150

  void RecordDisassociated (Mac48Address address);

296

  void RecordDisassociated (Mac48Address address);

151

297

152

/**

298

/**

Lines 168-174	Link Here

168

   * \param header MAC header

314

   * \param header MAC header

169

   * \param packet the packet to send

315

   * \param packet the packet to send

170

   * \param fullPacketSize the size of the packet after its 802.11 MAC header has been added.

316

   * \param fullPacketSize the size of the packet after its 802.11 MAC header has been added.

171

   * \returns the transmission mode to use to send this packet

317

   * \return the transmission mode to use to send this packet

172

*/

318

*/

173

  WifiTxVector GetDataTxVector (Mac48Address address, const WifiMacHeader *header,

319

  WifiTxVector GetDataTxVector (Mac48Address address, const WifiMacHeader *header,

174

                        Ptr<const Packet> packet, uint32_t fullPacketSize);

320

                        Ptr<const Packet> packet, uint32_t fullPacketSize);

Lines 176-224	Link Here

176

   * \param address remote address

322

   * \param address remote address

177

   * \param header MAC header

323

   * \param header MAC header

178

   * \param packet the packet to send

324

   * \param packet the packet to send

179

   * \returns the transmission mode to use to send the RTS prior to the

325

326

   * \return the transmission mode to use to send the RTS prior to the

180

   *          transmission of the data packet itself.

327

   *          transmission of the data packet itself.

181

*/

328

*/

182

  WifiTxVector GetRtsTxVector (Mac48Address address, const WifiMacHeader *header,

329

  WifiTxVector GetRtsTxVector (Mac48Address address, const WifiMacHeader *header,

183

                       Ptr<const Packet> packet);

330

                       Ptr<const Packet> packet);

184

331

332

/**

333

   * \param header MAC header

334

   * \param packet the packet to send

335

336

   * \return the transmission mode to use to send the CTS-to-self prior to the

337

   *          transmission of the data packet itself.

338

*/

185

  WifiTxVector GetCtsToSelfTxVector (const WifiMacHeader *header,

339

  WifiTxVector GetCtsToSelfTxVector (const WifiMacHeader *header,

186

                       Ptr<const Packet> packet);

340

                       Ptr<const Packet> packet);

187

341

188

  //Since CTS to Self parameters don't depened on the station it is implemented in wifiremote station manager

342

/**

343

   * Since CTS-to-self parameters are not dependent on the station,

344

   * it is implemented in wifiremote station manager

345

*/

189

  WifiTxVector DoGetCtsToSelfTxVector (void);

346

  WifiTxVector DoGetCtsToSelfTxVector (void);

190

347

191

348

192

/**

349

/**

193

   * Should be invoked whenever the RtsTimeout associated to a transmission

350

   * Should be invoked whenever the RtsTimeout associated to a transmission

194

   * attempt expires.

351

   * attempt expires.

352

353

   * \param address the address of the receiver

354

   * \param header MAC header of the DATA packet

195

*/

355

*/

196

  void ReportRtsFailed (Mac48Address address, const WifiMacHeader *header);

356

  void ReportRtsFailed (Mac48Address address, const WifiMacHeader *header);

197

/**

357

/**

198

   * Should be invoked whenever the AckTimeout associated to a transmission

358

   * Should be invoked whenever the AckTimeout associated to a transmission

199

   * attempt expires.

359

   * attempt expires.

360

361

   * \param address the address of the receiver

362

   * \param header MAC header of the DATA packet

200

*/

363

*/

201

  void ReportDataFailed (Mac48Address address, const WifiMacHeader *header);

364

  void ReportDataFailed (Mac48Address address, const WifiMacHeader *header);

202

/**

365

/**

203

   * Should be invoked whenever we receive the Cts associated to an RTS

366

   * Should be invoked whenever we receive the Cts associated to an RTS

204

   * we just sent.

367

   * we just sent. Note that we also get the SNR of the RTS we sent since

368

   * the receiver put a SnrTag in the CTS.

369

370

   * \param address the address of the receiver

371

   * \param header MAC header of the DATA packet

372

   * \param ctsSnr the SNR of the CTS we received

373

   * \param ctsMode the WifiMode the receiver used to send the CTS

374

   * \param rtsSnr the SNR of the RTS we sent

205

*/

375

*/

206

  void ReportRtsOk (Mac48Address address, const WifiMacHeader *header,

376

  void ReportRtsOk (Mac48Address address, const WifiMacHeader *header,

207

                    double ctsSnr, WifiMode ctsMode, double rtsSnr);

377

                    double ctsSnr, WifiMode ctsMode, double rtsSnr);

208

/**

378

/**

209

   * Should be invoked whenever we receive the Ack associated to a data packet

379

   * Should be invoked whenever we receive the Ack associated to a data packet

210

   * we just sent.

380

   * we just sent.

381

382

   * \param address the address of the receiver

383

   * \param header MAC header of the DATA packet

384

   * \param ackSnr the SNR of the ACK we received

385

   * \param ackMode the WifiMode the receiver used to send the ACK

386

   * \param dataSnr the SNR of the DATA we sent

211

*/

387

*/

212

  void ReportDataOk (Mac48Address address, const WifiMacHeader *header,

388

  void ReportDataOk (Mac48Address address, const WifiMacHeader *header,

213

                     double ackSnr, WifiMode ackMode, double dataSnr);

389

                     double ackSnr, WifiMode ackMode, double dataSnr);

214

/**

390

/**

215

   * Should be invoked after calling ReportRtsFailed if

391

   * Should be invoked after calling ReportRtsFailed if

216

   * NeedRtsRetransmission returns false

392

   * NeedRtsRetransmission returns false

393

394

   * \param address the address of the receiver

395

   * \param header MAC header of the DATA packet

217

*/

396

*/

218

  void ReportFinalRtsFailed (Mac48Address address, const WifiMacHeader *header);

397

  void ReportFinalRtsFailed (Mac48Address address, const WifiMacHeader *header);

219

/**

398

/**

220

   * Should be invoked after calling ReportDataFailed if

399

   * Should be invoked after calling ReportDataFailed if

221

   * NeedDataRetransmission returns false

400

   * NeedDataRetransmission returns false

401

402

   * \param address the address of the receiver

403

   * \param header MAC header of the DATA packet

222

*/

404

*/

223

  void ReportFinalDataFailed (Mac48Address address, const WifiMacHeader *header);

405

  void ReportFinalDataFailed (Mac48Address address, const WifiMacHeader *header);

224

406

Lines 237-254	Link Here

237

   * \param address remote address

419

   * \param address remote address

238

   * \param header MAC header

420

   * \param header MAC header

239

   * \param packet the packet to send

421

   * \param packet the packet to send

240

   * \returns true if we want to use an RTS/CTS handshake for this

422

   * \return true if we want to use an RTS/CTS handshake for this

241

   *          packet before sending it, false otherwise.

423

   *          packet before sending it, false otherwise.

242

*/

424

*/

243

  bool NeedRts (Mac48Address address, const WifiMacHeader *header,

425

  bool NeedRts (Mac48Address address, const WifiMacHeader *header,

244

                Ptr<const Packet> packet);

426

                Ptr<const Packet> packet);

427

/**

428

   * Return if we need to do Cts-to-self before sending a DATA.

429

430

   * \return true if Cts-to-self is needed, false otherwise

431

*/

245

  bool NeedCtsToSelf (WifiTxVector txVector);

432

  bool NeedCtsToSelf (WifiTxVector txVector);

246

433

247

/**

434

/**

248

   * \param address remote address

435

   * \param address remote address

249

   * \param header MAC header

436

   * \param header MAC header

250

   * \param packet the packet to send

437

   * \param packet the packet to send

251

   * \returns true if we want to restart a failed RTS/CTS

438

   * \return true if we want to restart a failed RTS/CTS

252

   *          handshake, false otherwise.

439

   *          handshake, false otherwise.

253

*/

440

*/

254

  bool NeedRtsRetransmission (Mac48Address address, const WifiMacHeader *header,

441

  bool NeedRtsRetransmission (Mac48Address address, const WifiMacHeader *header,

Lines 257-263	Link Here

257

   * \param address remote address

444

   * \param address remote address

258

   * \param header MAC header

445

   * \param header MAC header

259

   * \param packet the packet to send

446

   * \param packet the packet to send

260

   * \returns true if we want to resend a packet

447

   * \return true if we want to resend a packet

261

   *          after a failed transmission attempt, false otherwise.

448

   *          after a failed transmission attempt, false otherwise.

262

*/

449

*/

263

  bool NeedDataRetransmission (Mac48Address address, const WifiMacHeader *header,

450

  bool NeedDataRetransmission (Mac48Address address, const WifiMacHeader *header,

Lines 267-273	Link Here

267

   * \param address remote address

454

   * \param address remote address

268

   * \param header MAC header

455

   * \param header MAC header

269

   * \param packet the packet to send

456

   * \param packet the packet to send

270

   * \returns true if this packet should be fragmented, false otherwise.

457

   * \return true if this packet should be fragmented, false otherwise.

271

*/

458

*/

272

  bool NeedFragmentation (Mac48Address address, const WifiMacHeader *header,

459

  bool NeedFragmentation (Mac48Address address, const WifiMacHeader *header,

273

                          Ptr<const Packet> packet);

460

                          Ptr<const Packet> packet);

Lines 276-282	Link Here

276

   * \param header MAC header

463

   * \param header MAC header

277

   * \param packet the packet to send

464

   * \param packet the packet to send

278

   * \param fragmentNumber the fragment index of the next fragment to send (starts at zero).

465

   * \param fragmentNumber the fragment index of the next fragment to send (starts at zero).

279

   * \returns the size of the corresponding fragment.

466

   * \return the size of the corresponding fragment.

280

*/

467

*/

281

  uint32_t GetFragmentSize (Mac48Address address, const WifiMacHeader *header,

468

  uint32_t GetFragmentSize (Mac48Address address, const WifiMacHeader *header,

282

                            Ptr<const Packet> packet, uint32_t fragmentNumber);

469

                            Ptr<const Packet> packet, uint32_t fragmentNumber);

Lines 285-291	Link Here

285

   * \param header MAC header

472

   * \param header MAC header

286

   * \param packet the packet to send

473

   * \param packet the packet to send

287

   * \param fragmentNumber the fragment index of the next fragment to send (starts at zero).

474

   * \param fragmentNumber the fragment index of the next fragment to send (starts at zero).

288

   * \returns the offset within the original packet where this fragment starts.

475

   * \return the offset within the original packet where this fragment starts.

289

*/

476

*/

290

  uint32_t GetFragmentOffset (Mac48Address address, const WifiMacHeader *header,

477

  uint32_t GetFragmentOffset (Mac48Address address, const WifiMacHeader *header,

291

                              Ptr<const Packet> packet, uint32_t fragmentNumber);

478

                              Ptr<const Packet> packet, uint32_t fragmentNumber);

Lines 294-300	Link Here

294

   * \param header MAC header

481

   * \param header MAC header

295

   * \param packet the packet to send

482

   * \param packet the packet to send

296

   * \param fragmentNumber the fragment index of the next fragment to send (starts at zero).

483

   * \param fragmentNumber the fragment index of the next fragment to send (starts at zero).

297

   * \returns true if this is the last fragment, false otherwise.

484

   * \return true if this is the last fragment, false otherwise.

298

*/

485

*/

299

  bool IsLastFragment (Mac48Address address, const WifiMacHeader *header,

486

  bool IsLastFragment (Mac48Address address, const WifiMacHeader *header,

300

                       Ptr<const Packet> packet, uint32_t fragmentNumber);

487

                       Ptr<const Packet> packet, uint32_t fragmentNumber);

Lines 302-357	Link Here

302

/**

489

/**

303

   * \param address remote address

490

   * \param address remote address

304

   * \param rtsMode the transmission mode used to send an RTS we just received

491

   * \param rtsMode the transmission mode used to send an RTS we just received

305

   * \returns the transmission mode to use for the CTS to complete the RTS/CTS

492

   * \return the transmission mode to use for the CTS to complete the RTS/CTS

306

   *          handshake.

493

   *          handshake.

307

*/

494

*/

308

  WifiTxVector GetCtsTxVector (Mac48Address address, WifiMode rtsMode);

495

  WifiTxVector GetCtsTxVector (Mac48Address address, WifiMode rtsMode);

309

/**

496

/**

310

   * \param address

497

   * \param address

311

   * \param dataMode the transmission mode used to send an ACK we just received

498

   * \param dataMode the transmission mode used to send an ACK we just received

312

   * \returns the transmission mode to use for the ACK to complete the data/ACK

499

   * \return the transmission mode to use for the ACK to complete the data/ACK

313

   *          handshake.

500

   *          handshake.

314

*/

501

*/

315

  WifiTxVector GetAckTxVector (Mac48Address address, WifiMode dataMode);

502

  WifiTxVector GetAckTxVector (Mac48Address address, WifiMode dataMode);

316

/**

503

/**

317

   * \param address

504

   * \param address

318

   * \param dataMode the transmission mode used to send an ACK we just received

505

   * \param dataMode the transmission mode used to send an ACK we just received

319

   * \returns the transmission mode to use for the ACK to complete the data/ACK

506

   * \return the transmission mode to use for the ACK to complete the data/ACK

320

   *          handshake.

507

   *          handshake.

321

*/

508

*/

322

  WifiTxVector GetBlockAckTxVector (Mac48Address address, WifiMode dataMode);

509

  WifiTxVector GetBlockAckTxVector (Mac48Address address, WifiMode dataMode);

323

/**

510

/**

324

   * \returns the default transmission power

511

   * \return the default transmission power

325

*/

512

*/

326

  uint8_t GetDefaultTxPowerLevel (void) const;

513

  uint8_t GetDefaultTxPowerLevel (void) const;

327

/**

514

/**

328

   * \param address of the remote station

515

   * \param address of the remote station

329

   * \returns information regarding the remote station associated with the given address

516

   * \return information regarding the remote station associated with the given address

330

*/

517

*/

331

  WifiRemoteStationInfo GetInfo (Mac48Address address);

518

  WifiRemoteStationInfo GetInfo (Mac48Address address);

332

/**

519

/**

333

   * Set the default transmission power level

520

   * Set the default transmission power level

521

522

   * \param the default transmission power level

334

*/

523

*/

335

  void SetDefaultTxPowerLevel (uint8_t txPower);

524

  void SetDefaultTxPowerLevel (uint8_t txPower);

336

/**

525

/**

337

  * \returns the number of transmit antennas supported by the phy layer

526

  * \return the number of transmit antennas supported by the phy layer

338

*/

527

*/

339

 uint32_t GetNumberOfTransmitAntennas (void);

528

 uint32_t GetNumberOfTransmitAntennas (void);

340

529

341

 protected:

530

 protected:

342

  virtual void DoDispose (void);

531

  virtual void DoDispose (void);

343

  // for convenience

532

/**

533

   * Return whether mode associated with the specified station at the specified index.

534

535

   * \param station the station being queried

536

   * \param i the index

537

   * \return WifiMode at the given index of the specified station

538

*/

344

  WifiMode GetSupported (const WifiRemoteStation *station, uint32_t i) const;

539

  WifiMode GetSupported (const WifiRemoteStation *station, uint32_t i) const;

540

/**

541

   * Return the number of modes supported by the given station.

542

543

   * \param station the station being queried

544

   * \return the number of modes supported by the given station

545

*/

345

  uint32_t GetNSupported (const WifiRemoteStation *station) const;

546

  uint32_t GetNSupported (const WifiRemoteStation *station) const;

346

  uint8_t GetMcsSupported (const WifiRemoteStation *station, uint32_t i) const;

547

  uint8_t GetMcsSupported (const WifiRemoteStation *station, uint32_t i) const;

347

  uint32_t GetNMcsSupported (const WifiRemoteStation *station) const;

548

  uint32_t GetNMcsSupported (const WifiRemoteStation *station) const;

348

549

550

/**

551

   * Return whether the given station supports short guard interval.

552

553

   * \param station the station being queried

554

   * \return true if the station supports short guard interval,

555

   *          false otherwise

556

*/

349

  bool GetShortGuardInterval (const WifiRemoteStation *station) const;

557

  bool GetShortGuardInterval (const WifiRemoteStation *station) const;

350

  bool GetStbc (const WifiRemoteStation *station) const;

558

  bool GetStbc (const WifiRemoteStation *station) const;

559

/**

560

   * Return whether the station supports Greenfield or not.

561

562

   * \param station the station being queried

563

   * \return true if Greenfield is supported by the station,

564

   *          false otherwise

565

*/

351

  bool GetGreenfield (const WifiRemoteStation *station) const;

566

  bool GetGreenfield (const WifiRemoteStation *station) const;

567

/**

568

   * Return the number of receive antenna the station has.

569

570

   * \param station the station being queried

571

   * \return the number of receive antenna the station has

572

*/

352

  uint32_t GetNumberOfReceiveAntennas (const WifiRemoteStation *station) const;

573

  uint32_t GetNumberOfReceiveAntennas (const WifiRemoteStation *station) const;

574

/**

575

   * Return the number of transmit antenna the station has.

576

577

   * \param station the station being queried

578

   * \return the number of transmit antenna the station has

579

*/

353

  uint32_t GetNumberOfTransmitAntennas (const WifiRemoteStation *station) const;

580

  uint32_t GetNumberOfTransmitAntennas (const WifiRemoteStation *station) const;

581

/**

582

   * Return the long retry limit of the given station.

583

584

   * \param station the station being queried

585

   * \return the long retry limit of the the station

586

*/

354

  uint32_t GetLongRetryCount (const WifiRemoteStation *station) const;

587

  uint32_t GetLongRetryCount (const WifiRemoteStation *station) const;

588

/**

589

   * Return the short retry limit of the given station.

590

591

   * \param station the station being queried

592

   * \return the short retry limit of the the station

593

*/

355

  uint32_t GetShortRetryCount (const WifiRemoteStation *station) const;

594

  uint32_t GetShortRetryCount (const WifiRemoteStation *station) const;

356

private:

595

private:

357

/**

596

/**

Lines 359-365	Link Here

359

   * \param packet the packet to send

598

   * \param packet the packet to send

360

   * \param normally indicates whether the normal 802.11 rts enable mechanism would

599

   * \param normally indicates whether the normal 802.11 rts enable mechanism would

361

   *        request that the rts is sent or not.

600

   *        request that the rts is sent or not.

362

   * \returns true if we want to use an RTS/CTS handshake for this

601

   * \return true if we want to use an RTS/CTS handshake for this

363

   *          packet before sending it, false otherwise.

602

   *          packet before sending it, false otherwise.

364

603

365

   * Note: This method is called before a unicast packet is sent on the medium.

604

   * Note: This method is called before a unicast packet is sent on the medium.

Lines 371-377	Link Here

371

   * \param packet the packet to send

610

   * \param packet the packet to send

372

   * \param normally indicates whether the normal 802.11 rts enable mechanism would

611

   * \param normally indicates whether the normal 802.11 rts enable mechanism would

373

   *        request that the rts is retransmitted or not.

612

   *        request that the rts is retransmitted or not.

374

   * \returns true if we want to restart a failed RTS/CTS

613

   * \return true if we want to restart a failed RTS/CTS

375

   *          handshake, false otherwise.

614

   *          handshake, false otherwise.

376

615

377

   * Note: This method is called after an rts/cts handshake has been attempted

616

   * Note: This method is called after an rts/cts handshake has been attempted

Lines 384-390	Link Here

384

   * \param packet the packet to send

623

   * \param packet the packet to send

385

   * \param normally indicates whether the normal 802.11 data retransmission mechanism

624

   * \param normally indicates whether the normal 802.11 data retransmission mechanism

386

   *        would request that the data is retransmitted or not.

625

   *        would request that the data is retransmitted or not.

387

   * \returns true if we want to resend a packet

626

   * \return true if we want to resend a packet

388

   *          after a failed transmission attempt, false otherwise.

627

   *          after a failed transmission attempt, false otherwise.

389

628

390

   * Note: This method is called after a unicast packet transmission has been attempted

629

   * Note: This method is called after a unicast packet transmission has been attempted

Lines 398-411	Link Here

398

   * \param packet the packet to send

637

   * \param packet the packet to send

399

   * \param normally indicates whether the normal 802.11 data fragmentation mechanism

638

   * \param normally indicates whether the normal 802.11 data fragmentation mechanism

400

   *        would request that the data packet is fragmented or not.

639

   *        would request that the data packet is fragmented or not.

401

   * \returns true if this packet should be fragmented, false otherwise.

640

   * \return true if this packet should be fragmented, false otherwise.

402

641

403

   * Note: This method is called before sending a unicast packet.

642

   * Note: This method is called before sending a unicast packet.

404

*/

643

*/

405

  virtual bool DoNeedFragmentation (WifiRemoteStation *station,

644

  virtual bool DoNeedFragmentation (WifiRemoteStation *station,

406

                                    Ptr<const Packet> packet, bool normally);

645

                                    Ptr<const Packet> packet, bool normally);

407

/**

646

/**

408

   * \returns whether this manager is a manager designed to work in low-latency

647

   * \return whether this manager is a manager designed to work in low-latency

409

   *          environments.

648

   *          environments.

410

649

411

   * Note: In this context, low vs high latency is defined in <i>IEEE 802.11 Rate Adaptation:

650

   * Note: In this context, low vs high latency is defined in <i>IEEE 802.11 Rate Adaptation:

Lines 419-425	Link Here

419

/**

658

/**

420

   * \param station the station with which we need to communicate

659

   * \param station the station with which we need to communicate

421

   * \param size size of the packet or fragment we want to send

660

   * \param size size of the packet or fragment we want to send

422

   * \returns the transmission mode to use to send a packet to the station

661

   * \return the transmission mode to use to send a packet to the station

423

662

424

   * Note: This method is called before sending a unicast packet or a fragment

663

   * Note: This method is called before sending a unicast packet or a fragment

425

   *       of a unicast packet to decide which transmission mode to use.

664

   *       of a unicast packet to decide which transmission mode to use.

Lines 428-434	Link Here

428

                                  uint32_t size) = 0;

667

                                  uint32_t size) = 0;

429

/**

668

/**

430

   * \param station the station with which we need to communicate

669

   * \param station the station with which we need to communicate

431

   * \returns the transmission mode to use to send an rts to the station

670

   * \return the transmission mode to use to send an rts to the station

432

671

433

   * Note: This method is called before sending an rts to a station

672

   * Note: This method is called before sending an rts to a station

434

   *       to decide which transmission mode to use for the rts.

673

   *       to decide which transmission mode to use for the rts.

Lines 446-452	Link Here

446

685

447

/**

686

/**

448

   * \param address the address of the recipient of the ACK

687

   * \param address the address of the recipient of the ACK

449

   * \param ctsMode the mode to be used for the ACK

688

   * \param ackMode the mode to be used for the ACK

450

689

451

   * \return the power level to be used to send the ACK

690

   * \return the power level to be used to send the ACK

452

*/

691

*/

Lines 454-460	Link Here

454

693

455

/**

694

/**

456

   * \param address the address of the recipient of the Block ACK

695

   * \param address the address of the recipient of the Block ACK

457

   * \param ctsMode the mode to be used for the Block ACK

696

   * \param blockAckMode the mode to be used for the Block ACK

458

697

459

   * \return the power level to be used to send the Block ACK

698

   * \return the power level to be used to send the Block ACK

460

*/

699

*/

Lines 474-501	Link Here

474

  virtual uint8_t DoGetBlockAckTxNess(Mac48Address address, WifiMode blockAckMode);

713

  virtual uint8_t DoGetBlockAckTxNess(Mac48Address address, WifiMode blockAckMode);

475

  virtual bool DoGetBlockAckTxStbc(Mac48Address address, WifiMode blockAckMode);

714

  virtual bool DoGetBlockAckTxStbc(Mac48Address address, WifiMode blockAckMode);

476

715

716

/**

717

   * This method is a pure virtual method that must be implemented by the sub-class.

718

   * This allows different types of WifiRemoteStationManager to respond differently,

719

720

   * \param station the station with which we failed to send RTS

721

*/

477

  virtual void DoReportRtsFailed (WifiRemoteStation *station) = 0;

722

  virtual void DoReportRtsFailed (WifiRemoteStation *station) = 0;

723

/**

724

   * This method is a pure virtual method that must be implemented by the sub-class.

725

   * This allows different types of WifiRemoteStationManager to respond differently,

726

727

   * \param station the station with which we failed to send DATA

728

*/

478

  virtual void DoReportDataFailed (WifiRemoteStation *station) = 0;

729

  virtual void DoReportDataFailed (WifiRemoteStation *station) = 0;

730

/**

731

   * This method is a pure virtual method that must be implemented by the sub-class.

732

   * This allows different types of WifiRemoteStationManager to respond differently,

733

734

   * \param station the station with which we successfully sent RTS

735

   * \param ctsSnr the SNR of the CTS we received

736

   * \param ctsMode the WifiMode the receiver used to send the CTS

737

   * \param rtsSnr the SNR of the RTS we sent

738

*/

479

  virtual void DoReportRtsOk (WifiRemoteStation *station,

739

  virtual void DoReportRtsOk (WifiRemoteStation *station,

480

                              double ctsSnr, WifiMode ctsMode, double rtsSnr) = 0;

740

                              double ctsSnr, WifiMode ctsMode, double rtsSnr) = 0;

741

/**

742

   * This method is a pure virtual method that must be implemented by the sub-class.

743

   * This allows different types of WifiRemoteStationManager to respond differently,

744

745

   * \param station the station with which we successfully sent RTS

746

   * \param ackSnr the SNR of the ACK we received

747

   * \param ackMode the WifiMode the receiver used to send the ACK

748

   * \param dataSnr the SNR of the DATA we sent

749

*/

481

  virtual void DoReportDataOk (WifiRemoteStation *station,

750

  virtual void DoReportDataOk (WifiRemoteStation *station,

482

                               double ackSnr, WifiMode ackMode, double dataSnr) = 0;

751

                               double ackSnr, WifiMode ackMode, double dataSnr) = 0;

752

/**

753

   * This method is a pure virtual method that must be implemented by the sub-class.

754

   * This allows different types of WifiRemoteStationManager to respond differently,

755

756

   * \param station the station with which we failed to send RTS

757

*/

483

  virtual void DoReportFinalRtsFailed (WifiRemoteStation *station) = 0;

758

  virtual void DoReportFinalRtsFailed (WifiRemoteStation *station) = 0;

759

/**

760

   * This method is a pure virtual method that must be implemented by the sub-class.

761

   * This allows different types of WifiRemoteStationManager to respond differently,

762

763

   * \param station the station with which we failed to send DATA

764

*/

484

  virtual void DoReportFinalDataFailed (WifiRemoteStation *station) = 0;

765

  virtual void DoReportFinalDataFailed (WifiRemoteStation *station) = 0;

766

/**

767

   * This method is a pure virtual method that must be implemented by the sub-class.

768

   * This allows different types of WifiRemoteStationManager to respond differently,

769

770

   * \param station the station that sent the DATA to us

771

   * \param rxSnr the SNR of the DATA we received

772

   * \param txMode the WifiMode the sender used to send the DATA

773

*/

485

  virtual void DoReportRxOk (WifiRemoteStation *station,

774

  virtual void DoReportRxOk (WifiRemoteStation *station,

486

                             double rxSnr, WifiMode txMode) = 0;

775

                             double rxSnr, WifiMode txMode) = 0;

487

776

777

/**

778

   * Return the state of the station associated with the given address.

779

780

   * \param address the address of the station

781

   * \return WifiRemoteStationState corresponding to the address

782

*/

488

  WifiRemoteStationState* LookupState (Mac48Address address) const;

783

  WifiRemoteStationState* LookupState (Mac48Address address) const;

784

/**

785

   * Return the station associated with the given address and TID.

786

787

   * \param address the address of the station

788

   * \param tid the TID

789

   * \return WifiRemoteStation corresponding to the address

790

*/

489

  WifiRemoteStation* Lookup (Mac48Address address, uint8_t tid) const;

791

  WifiRemoteStation* Lookup (Mac48Address address, uint8_t tid) const;

490

  /// Find a remote station by its remote address and TID taken from MAC header

792

  /// Find a remote station by its remote address and TID taken from MAC header

793

/**

794

   * Return the station associated with the given address and MAC header.

795

   * It simply gets TID from the MAC header and calls Lookup with tid.

796

797

   * \param address the address of the station

798

   * \param header MAC header

799

   * \return WifiRemoteStation corresponding to the address

800

*/

491

  WifiRemoteStation* Lookup (Mac48Address address, const WifiMacHeader *header) const;

801

  WifiRemoteStation* Lookup (Mac48Address address, const WifiMacHeader *header) const;

492

  WifiMode GetControlAnswerMode (Mac48Address address, WifiMode reqMode);

802

  WifiMode GetControlAnswerMode (Mac48Address address, WifiMode reqMode);

493

803

804

/**

805

   * Actually sets the fragmentation threshold, it also checks the validity of

806

   * the given threshold.

807

808

   * \param threshold the fragmentation threshold

809

*/

494

  void DoSetFragmentationThreshold (uint32_t threshold);

810

  void DoSetFragmentationThreshold (uint32_t threshold);

811

/**

812

   * Return the current fragmentation threshold

813

814

   * \return the fragmentation threshold

815

*/

495

  uint32_t DoGetFragmentationThreshold (void) const;

816

  uint32_t DoGetFragmentationThreshold (void) const;

817

/**

818

   * Return the number of fragments needed for the given packet.

819

820

   * \param header MAC header

821

   * \param packet the packet to be fragmented

822

   * \return the number of fragments needed

823

*/

496

  uint32_t GetNFragments (const WifiMacHeader *header, Ptr<const Packet> packet);

824

  uint32_t GetNFragments (const WifiMacHeader *header, Ptr<const Packet> packet);

497

825

826

/**

827

   * A vector of WifiRemoteStations

828

*/

498

  typedef std::vector <WifiRemoteStation *> Stations;

829

  typedef std::vector <WifiRemoteStation *> Stations;

830

/**

831

   * A vector of WifiRemoteStationStates

832

*/

499

  typedef std::vector <WifiRemoteStationState *> StationStates;

833

  typedef std::vector <WifiRemoteStationState *> StationStates;

500

834

501

  StationStates m_states;

835

  StationStates m_states;

Lines 552-557	Link Here

552

886

553

};

887

};

554

888

889

/**

890

 * A struct that holds information about each remote station.

891

*/

555

struct WifiRemoteStationState

892

struct WifiRemoteStationState

556

893

557

  enum

894

  enum

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

Lines 62-71	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 logarithm of the given value to base 2.

   * \param val

   * \return the logarithm of val to base 2.

*/

  double Log2 (double val) const;

  double Log2 (double val) const;

/**

   * Return BER of BPSK with the given parameters.

   * \param snr snr value

   * \param signalSpread

   * \param phyRate

   * \return BER of BPSK at the given SNR

*/

  double GetBpskBer (double snr, uint32_t signalSpread, uint32_t phyRate) const;

  double GetBpskBer (double snr, uint32_t signalSpread, uint32_t phyRate) const;

/**

   * Return BER of QAM-m with the given parameters.

   * \param snr snr value

   * \param m

   * \param signalSpread

   * \param phyRate

   * \return BER of BPSK at the given SNR

*/

  double GetQamBer (double snr, unsigned int m, uint32_t signalSpread, uint32_t phyRate) const;

  double GetQamBer (double snr, unsigned int m, uint32_t signalSpread, uint32_t phyRate) const;

/**

   * Return k!

   * \return k!

*/

  uint32_t Factorial (uint32_t k) const;

  uint32_t Factorial (uint32_t k) const;

/**

   * Return Binomial distribution for a given k, p, and n

100

   * \param k

101

   * \param p

102

   * \param n

103

   * \return a Binomial distribution

104

*/

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

105

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

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

106

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

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

107

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

(-)a/src/wifi/model/yans-wifi-channel.h (-1 / +20 lines)

Lines 59-64	Link Here

  virtual uint32_t GetNDevices (void) const;

  virtual uint32_t GetNDevices (void) const;

  virtual Ptr<NetDevice> GetDevice (uint32_t i) const;

  virtual Ptr<NetDevice> GetDevice (uint32_t i) const;

/**

   * Adds the given YansWifiPhy to the PHY list

   * \param phy the YansWifiPhy to be added to the PHY list

*/

  void Add (Ptr<YansWifiPhy> phy);

  void Add (Ptr<YansWifiPhy> phy);

/**

/**

Lines 74-80	Link Here

   * \param sender the device from which the packet is originating.

   * \param sender the device from which the packet is originating.

   * \param packet the packet to send

   * \param packet the packet to send

   * \param txPowerDbm the tx power associated to the packet

   * \param txPowerDbm the tx power associated to the packet

   * \param wifiMode the tx mode associated to the packet

   * \param txVector the TXVECTOR associated to the packet

   * \param preamble the preamble associated to the packet

   * \param preamble the preamble associated to the packet

   * This method should not be invoked by normal users. It is

   * This method should not be invoked by normal users. It is

Lines 99-105	Link Here

  YansWifiChannel& operator = (const YansWifiChannel &);

104

  YansWifiChannel& operator = (const YansWifiChannel &);

100

  YansWifiChannel (const YansWifiChannel &);

105

  YansWifiChannel (const YansWifiChannel &);

101

106

107

/**

108

   * A vector of pointers to YansWifiPhy.

109

*/

102

  typedef std::vector<Ptr<YansWifiPhy> > PhyList;

110

  typedef std::vector<Ptr<YansWifiPhy> > PhyList;

111

/**

112

   * This method is scheduled by Send for each associated YansWifiPhy.

113

   * The method then calls the corresponding YansWifiPhy that the first

114

   * bit of the packet has arrived.

115

116

   * \param i index of the corresponding YansWifiPhy in the PHY list

117

   * \param packet the packet being sent

118

   * \param rxPowerDbm the received power of the packet

119

   * \param txVector the TXVECTOR of the packet

120

   * \param preamble the type of preamble being used to send the packet

121

*/

103

  void Receive (uint32_t i, Ptr<Packet> packet, double rxPowerDbm,

122

  void Receive (uint32_t i, Ptr<Packet> packet, double rxPowerDbm,

104

                WifiTxVector txVector, WifiPreamble preamble) const;

123

                WifiTxVector txVector, WifiPreamble preamble) const;

105

124

(-)a/src/wifi/model/yans-wifi-phy.cc (-2 / +2 lines)

Lines 863-871	Link Here

863

  return m_guardInterval;

863

  return m_guardInterval;

864

865

void

865

void

866

YansWifiPhy::SetGuardInterval (bool GuardInterval)

866

YansWifiPhy::SetGuardInterval (bool guardInterval)

867

868

  m_guardInterval = GuardInterval;

868

  m_guardInterval = guardInterval;

869

870

871

uint32_t

871

uint32_t





  void SetChannel (Ptr<YansWifiChannel> channel);

  void SetChannelNumber (uint16_t id);
  uint16_t GetChannelNumber () const;
  /**
   * Return current center channel frequency in MHz.
   *
   * \return the current center channel frequency in MHz
   */  
   * where Starting channel frequency is standard-dependent, see SetStandard()
   * as defined in IEEE 802.11-2007 17.3.8.3.2.
   *
   * YansWifiPhy can switch among different channels. Basically, YansWifiPhy
   * has a private attribute m_channelNumber that identifies the channel the
   * PHY operates on. Channel switching cannot interrupt an ongoing transmission.
   * When PHY is in TX state, the channel switching is postponed until the end
   * of the current transmission. When the PHY is in RX state, the channel
   * switching causes the drop of the synchronized packet.
   */
  void SetChannelNumber (uint16_t id);
  /// Return current channel number, see SetChannelNumber()
  uint16_t GetChannelNumber () const;
  /// Return current center channel frequency in MHz, see SetChannelNumber()
  double GetChannelFrequencyMhz () const;

  void StartReceivePacket (Ptr<Packet> packet,

                           WifiTxVector txVector,
                           WifiPreamble preamble);

  /**
   * Sets the RX loss (dB) in the Signal-to-Noise-Ratio due to non-idealities in the receiver.
   *
   * \param noiseFigureDb noise figure in dB
   */
  void SetRxNoiseFigure (double noiseFigureDb);
  /**
   * Sets the minimum available transmission power level (dBm).
   *
   * \param start the minimum transmission power level (dBm)
   */
  void SetTxPowerStart (double start);
  /**
   * Sets the maximum available transmission power level (dBm).
   *
   * \param end the maximum transmission power level (dBm)
   */
  void SetTxPowerEnd (double end);
  /**
   * Sets the number of transmission power levels available between the
   * minimum level and the maximum level.  Transmission power levels are
   * equally separated (in dBm) with the minimum and the maximum included.
   *
   * \param n the number of available levels
   */
  void SetNTxPower (uint32_t n);
  /**
   * Sets the transmission gain (dB).
   *
   * \param gain the transmission gain in dB
   */
  void SetTxGain (double gain);
  /**
   * Sets the reception gain (dB).
   *
   * \param gain the reception gain in dB
   */
  void SetRxGain (double gain);
  /**
   * Sets the energy detection threshold (dBm).
   * The energy of a received signal should be higher than
   * this threshold (dbm) to allow the PHY layer to detect the signal.
   *
   * \param threshold the energy detction threshold in dBm
   */
  void SetEdThreshold (double threshold);
  /**
   * Sets the CCA threshold (dBm).  The energy of a received signal
   * should be higher than this threshold to allow the PHY
   * layer to declare CCA BUSY state.
   *
   * \param threshold the CCA threshold in dBm
   */
  void SetCcaMode1Threshold (double threshold);
  /**
   * Sets the error rate model.
   *
   * \param rate the error rate model
   */
  void SetErrorRateModel (Ptr<ErrorRateModel> rate);
  /**
   * Sets the device this PHY is associated with.
   *
   * \param device the device this PHY is associated with
   */
  void SetDevice (Ptr<Object> device);
  /**
   * Sets the mobility model.
   *
   * \param mobility the mobility model this PHY is associated with
   */
  void SetMobility (Ptr<Object> mobility);
  /**
   * Return the RX noise figure (dBm).
   *
   * \return the RX noise figure in dBm
   */
  double GetRxNoiseFigure (void) const;
  /**
   * Return the transmission gain (dB).
   *
   * \return the transmission gain in dB
   */
  double GetTxGain (void) const;
  /**
   * Return the reception gain (dB).
   *
   * \return the reception gain in dB
   */
  double GetRxGain (void) const;
  /**
   * Return the energy detection threshold (dBm).
   *
   * \return the energy detection threshold in dBm
   */
  double GetEdThreshold (void) const;
  /**
   * Return the CCA threshold (dBm).
   *
   * \return the CCA threshold in dBm
   */
  double GetCcaMode1Threshold (void) const;
  /**
   * Return the error rate model this PHY is using.
   *
   * \return the error rate model this PHY is using
   */
  Ptr<ErrorRateModel> GetErrorRateModel (void) const;
  /**
   * Return the device this PHY is associated with
   *
   * \return the device this PHY is associated with
   */
  Ptr<Object> GetDevice (void) const;
  /**
   * Return the mobility model this PHY is associated with.
   *
   * \return the mobility model this PHY is associated with
   */
  Ptr<Object> GetMobility (void);




  virtual double GetTxPowerStart (void) const;
  virtual double GetTxPowerEnd (void) const;
  /**
   * Return the number of available transmission power levels.
   *
   * \return the number of available transmission power levels
   */
  virtual uint32_t GetNTxPower (void) const;
  virtual void SetReceiveOkCallback (WifiPhy::RxOkCallback callback);
  virtual void SetReceiveErrorCallback (WifiPhy::RxErrorCallback callback);

  virtual WifiMode GetMode (uint32_t mode) const;
  virtual double CalculateSnr (WifiMode txMode, double ber) const;
  virtual Ptr<WifiChannel> GetChannel (void) const;
  
  virtual void ConfigureStandard (enum WifiPhyStandard standard);

 /**

  int64_t AssignStreams (int64_t stream);

  /**
   * \param freq the operating frequency on this node (2.4 GHz or 5GHz).
   */
  virtual void SetFrequency (uint32_t freq);
  /**
   * \return the operating frequency on this node
   */
  virtual uint32_t GetFrequency (void) const;
  /**
   * \param tx the number of transmitters on this node.
   */
  virtual void SetNumberOfTransmitAntennas (uint32_t tx);
  virtual uint32_t GetNumberOfTransmitAntennas (void) const;
  /**
   * \param rx the number of receivers on this node.
   */
  virtual void SetNumberOfReceiveAntennas (uint32_t rx) ;
  /**
   * \return the number of receivers on this node.
   */
  virtual uint32_t GetNumberOfReceiveAntennas (void) const;
  /**
   * Enable or disable short/long guard interval.
   *
   * \param guardInterval Enable or disable guard interval
   */
  virtual void SetGuardInterval (bool guardInterval);
   virtual bool GetGuardInterval (void) const;
  /**
   * Return whether guard interval is being used.
   *
   * \return true if guard interval is being used, false otherwise
   */
  virtual bool GetGuardInterval (void) const;
  /**
   * Enable or disable LDPC.
   * \param ldpc Enable or disable LDPC
   */
  virtual void SetLdpc (bool ldpc);
  /**
   * Return if LDPC is supported.
   *
   * \return true if LDPC is supported, false otherwise
   */
  virtual bool GetLdpc (void) const;
  /**
   * Enable or disable STBC.
   *
   * \param stbc Enable or disable STBC
   */
  virtual void SetStbc (bool stbc);
  /**
   * Return whether STBC is supported. 
   *
   * \return true if STBC is supported, false otherwise
   */
  virtual bool GetStbc (void) const;
  /**
   * Enable or disable Greenfield support.
   *
   * \param greenfield Enable or disable Greenfield
   */
  virtual void SetGreenfield (bool greenfield);
  /**
   * Return whether Greenfield is supported.
   *
   * \return true if Greenfield is supported, false otherwise
   */
  virtual bool GetGreenfield (void) const;
  /**
   * Return whether channel bonding is supported.
   * 
   * \return true if channel bonding is supported, false otherwise
   */
  virtual bool GetChannelBonding (void) const ;
  /**
   * Enable or disable channel bonding support.
   * 
   * \param channelBonding Enable or disable channel bonding
   */
  virtual void SetChannelBonding (bool channelbonding) ;


  virtual uint32_t GetBssMembershipSelector (uint32_t selector) const;
  virtual WifiModeList GetMembershipSelectorModes(uint32_t selector);
  /**
   * \return the number of MCS supported by this phy
   */
  virtual uint8_t GetNMcs (void) const;
  virtual uint8_t GetMcs (uint8_t mcs) const;

  * as defined in the IEEE 802.11n standard 
  *
  * \param mode the WifiMode
  * \return the MCS number that corresponds to the given WifiMode
  */
  virtual uint32_t WifiModeToMcs (WifiMode mode);
 /**

  * as defined in the IEEE 802.11n standard. 
  * 
  * \param mcs the MCS number 
  * \return the WifiMode that corresponds to the given mcs number
  */
  virtual WifiMode McsToWifiMode (uint8_t mcs);


Return to bug 938