/usr/include/ns3.27/ns3/vht-capabilities.h is in libns3-dev 3.27+dfsg-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 | /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
/*
* Copyright (c) 2015
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License version 2 as
* published by the Free Software Foundation;
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*
* Authors: Ghada Badawy <gbadawy@gmail.com>
* Sébastien Deronne <sebastien.deronne@gmail.com>
*/
#ifndef VHT_CAPABILITIES_H
#define VHT_CAPABILITIES_H
#include "ns3/buffer.h"
#include "wifi-information-element.h"
namespace ns3 {
/**
* \ingroup wifi
*
* The IEEE 802.11ac VHT Capabilities
*/
class VhtCapabilities : public WifiInformationElement
{
public:
VhtCapabilities ();
/**
* Set the VHT supported field.
*
* \param vhtsupported the VHT supported field
*/
void SetVhtSupported (uint8_t vhtsupported);
/**
* Return the element ID.
*
* \returns the wifi information element ID
*/
WifiInformationElementId ElementId () const;
/**
* Return the information field size.
*
* \returns the information field size
*/
uint8_t GetInformationFieldSize () const;
/**
* Serialize the information field.
*
* \param start the information field iterator
*/
void SerializeInformationField (Buffer::Iterator start) const;
/**
* Deserialize the information field.
*
* \param start the information field iterator
* \param length the information field
* \returns the information field
*/
uint8_t DeserializeInformationField (Buffer::Iterator start, uint8_t length);
/**
* Set the VHT Capabilties Info field in the VHT Capabilities information element.
*
* \param ctrl the VHT Capabilties Info field in the VHT Capabilities information element
*/
void SetVhtCapabilitiesInfo (uint32_t ctrl);
/**
* Set the MCS and NSS field in the VHT Capabilities information element.
*
* \param ctrl the MCS and NSS field in the VHT Capabilities information element
*/
void SetSupportedMcsAndNssSet (uint64_t ctrl);
/**
* Return the VHT Capabilties Info field in the VHT Capabilities information element.
*
* \return the VHT Capabilties Info field in the VHT Capabilities information element
*/
uint32_t GetVhtCapabilitiesInfo () const;
/**
* Return the MCS and NSS field in the VHT Capabilities information element.
*
* \return the MCS and NSS field in the VHT Capabilities information element
*/
uint64_t GetSupportedMcsAndNssSet () const;
//Capabilities Info fields
/**
* Set the maximum MPDU length.
*
* \param length the maximum MPDU length
*/
void SetMaxMpduLength (uint8_t length);
/**
* Set the supported channel width set.
*
* \param channelwidthset the supported channel width set
*/
void SetSupportedChannelWidthSet (uint8_t channelwidthset);
/**
* Set the receive LDPC.
*
* \param rxldpc the receive LDPC
*/
void SetRxLdpc (uint8_t rxldpc);
/**
* Set the short guard interval 80 Mhz.
*
* \param shortguardinterval the short guard interval 80 Mhz
*/
void SetShortGuardIntervalFor80Mhz (uint8_t shortguardinterval);
/**
* Set the short guard interval 160 Mhz.
*
* \param shortguardinterval the short guard interval 160 Mhz
*/
void SetShortGuardIntervalFor160Mhz (uint8_t shortguardinterval);
/**
* Set the receive STBC.
*
* \param rxstbc the receive STBC
*/
void SetRxStbc (uint8_t rxstbc);
/**
* Set the transmit STBC.
*
* \param txstbc the receive STBC
*/
void SetTxStbc (uint8_t txstbc);
/**
* Set the maximum AMPDU length exponent.
*
* \param exponent the maximum AMPDU length exponent
*/
void SetMaxAmpduLengthExponent (uint8_t exponent);
/**
* Get the maximum MPDU length.
*
* \returns the maximum MPDU length
*/
uint8_t GetMaxMpduLength () const;
/**
* Get the supported channel width set.
*
* \returns the maximum MPDU length
*/
uint8_t GetSupportedChannelWidthSet () const;
/**
* Get the receive LDPC.
*
* \returns the receive LDPC
*/
uint8_t GetRxLdpc () const;
/**
* Get the short guard interval 80 MHz.
*
* \returns the short guard interval 80 MHz
*/
uint8_t GetShortGuardIntervalFor80Mhz () const;
/**
* Get the short guard interval 80 MHz.
*
* \returns the short guard interval 80 MHz
*/
uint8_t GetShortGuardIntervalFor160Mhz () const;
/**
* Get the receive STBC.
*
* \returns the receive STBC
*/
uint8_t GetRxStbc () const;
/**
* Get the transmit STBC.
*
* \returns the transmit STBC
*/
uint8_t GetTxStbc () const;
/**
* Get the maximum AMPDU length exponent.
*
* \returns the maximum AMPDU length exponent
*/
uint8_t GetMaxAmpduLengthExponent () const;
// MCS and NSS field information
// For each value of NSS ranging from 1 to 8, we need to encode two bits.
// The value 0 indicates that the maximum MCS for that spatial stream is 7.
// The value 1 indicates that the maximum MCS for that spatial stream is 8.
// The value 2 indicates that the maximum MCS for that spatial stream is 9.
//
// The maps may be set all at once by passing in a 16-bit field corresponding
// to the above, or incrementally for each NSS separately, where the
// MCS value must be in the range 7-9.
/**
* \param map The 16-bit encoding of Max MCS for each of 8 spatial streams
*/
void SetRxMcsMap (uint16_t map);
/**
* \param mcs Max MCS value (between 7 and 9)
* \param nss Spatial stream for which the Max MCS value is being set
*/
void SetRxMcsMap (uint8_t mcs, uint8_t nss);
/**
* \param map The 16-bit encoding of Max MCS for each of 8 spatial streams
*/
void SetTxMcsMap (uint16_t map);
/**
* \param mcs Max MCS value (between 7 and 9)
* \param nss Spatial stream for which the Max MCS value is being set
*/
void SetTxMcsMap (uint8_t mcs, uint8_t nss);
/**
* Set the receive highest supported LGI data rate.
*
* \param supporteddatarate receive highest supported LGI data rate
*/
void SetRxHighestSupportedLgiDataRate (uint16_t supporteddatarate);
/**
* Set the transmit highest supported LGI data rate.
*
* \param supporteddatarate transmit highest supported LGI data rate
*/
void SetTxHighestSupportedLgiDataRate (uint16_t supporteddatarate);
/**
* Get the is MCS supported.
*
* \param mcs the MCS
* \param Nss the NSS
* \returns the is MCS supported
*/
bool IsSupportedMcs (uint8_t mcs, uint8_t Nss) const;
/**
* Get the receive MCS map.
*
* \returns the receive MCS map
*/
uint16_t GetRxMcsMap () const;
/**
* Get the transmit MCS map.
*
* \returns the transmit MCS map
*/
uint16_t GetTxMcsMap () const;
/**
* Get the receive highest supported LGI data rate.
*
* \returns the receive highest supported LGI data rate.
*/
uint16_t GetRxHighestSupportedLgiDataRate () const;
/**
* Get the transmit highest supported LGI data rate.
*
* \returns the transmit highest supported LGI data rate.
*/
uint16_t GetTxHighestSupportedLgiDataRate () const;
/**
* Get the is transmit MCS supported.
*
* \param mcs the MCS
* \returns is transmit MCS supported
*/
bool IsSupportedTxMcs (uint8_t mcs) const;
/**
* Get the is receive MCS supported.
*
* \param mcs the MCS
* \returns is receive MCS supported
*/
bool IsSupportedRxMcs (uint8_t mcs) const;
/**
* This information element is a bit special in that it is only
* included if the STA is an VHT STA. To support this we
* override the Serialize and GetSerializedSize methods of
* WifiInformationElement.
*
* \param start the iterator
* \returns the serialized size
*/
Buffer::Iterator Serialize (Buffer::Iterator start) const;
/**
* Get the serialized size.
*
* \returns the serialized size
*/
uint16_t GetSerializedSize () const;
private:
//Capabilities Info fields
uint16_t m_maxMpduLength; ///< maximum MPDU length
uint16_t m_supportedChannelWidthSet; ///< supported channel width set
uint8_t m_rxLdpc; ///< receive LDPC
uint8_t m_shortGuardIntervalFor80Mhz; ///< short guard interval 80 MHz
uint8_t m_shortGuardIntervalFor160Mhz; ///< short guard interval 160 MHz
uint8_t m_txStbc; ///< transmit STBC
uint8_t m_rxStbc; ///< receive STBC
uint8_t m_suBeamformerCapable; ///< SU beam former capable
uint8_t m_suBeamformeeCapable; ///< SU beam formee capable
uint8_t m_beamformeeStsCapable; ///< beam formee STS capable
uint8_t m_numberOfSoundingDimensions; ///< number of sounding dimensions
uint8_t m_muBeamformerCapable; ///< MU beam former capable
uint8_t m_muBeamformeeCapable; ///< MU beam formee capable
uint8_t m_vhtTxopPs; ///< VHT TXOP PS
uint8_t m_htcVhtCapable; ///< HTC VHT capable
uint8_t m_maxAmpduLengthExponent; ///< maximum AMPDU length exponent
uint8_t m_vhtLinkAdaptationCapable; ///< VHT link adaptation capable
uint8_t m_rxAntennaPatternConsistency; ///< receive antenna pattern consistency
uint8_t m_txAntennaPatternConsistency; ///< transmit antenna pattern consistency
//MCS and NSS field information
std::vector<uint8_t> m_rxMcsMap; ///< receive MCS map
uint16_t m_rxHighestSupportedLongGuardIntervalDataRate; ///< receive highest supported long guard interval data rate
std::vector<uint8_t> m_txMcsMap; ///< transmit MCS map
uint16_t m_txHighestSupportedLongGuardIntervalDataRate; ///< transmit highest supported long guard interval data rate
/// This is used to decide if this element should be added to the frame or not
uint8_t m_vhtSupported;
};
std::ostream &operator << (std::ostream &os, const VhtCapabilities &vhtcapabilities);
std::istream &operator >> (std::istream &is, VhtCapabilities &vhtcapabilities);
ATTRIBUTE_HELPER_HEADER (VhtCapabilities);
} //namespace ns3
#endif /* VHT_CAPABILITY_H */
|