Attachment #3047 for bug #2813

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




static std::map<WifiSpectrumModelId, Ptr<SpectrumModel> > g_wifiSpectrumModelMap; ///< static initializer for the class

Ptr<SpectrumModel>
WifiSpectrumValueHelper::GetSpectrumModel (uint32_t centerFrequency, uint8_t channelWidth, double bandBandwidth, double guardBandwidth)
{
  NS_LOG_FUNCTION (centerFrequency << (uint16_t)channelWidth << bandBandwidth << guardBandwidth);
  Ptr<SpectrumModel> ret;
  WifiSpectrumModelId key (centerFrequency, channelWidth, bandBandwidth);
  std::map<WifiSpectrumModelId, Ptr<SpectrumModel> >::iterator it = g_wifiSpectrumModelMap.find (key);

        {
          // round up to the nearest odd number of subbands so that bands
          // are symmetric around center frequency
          NS_LOG_DEBUG ("Total bandwidth evenly divided by 312.5 KHz");
          numBands += 1;    
        }
      NS_ASSERT_MSG (numBands % 2 == 1, "Number of bands should be odd");
      NS_LOG_DEBUG ("Num bands " << numBands << " band bandwidth " << bandBandwidth);
      // lay down numBands/2 bands symmetrically around center frequency
      // and place an additional band at center frequency
      double startingFrequencyHz = centerFrequencyHz - (numBands/2 * bandBandwidth) - bandBandwidth/2;


// Power allocated to 71 center subbands out of 135 total subbands in the band 
Ptr<SpectrumValue>
WifiSpectrumValueHelper::CreateDsssTxPowerSpectralDensity (uint32_t centerFrequency, double txPowerW, double guardBandwidth)
{
  NS_LOG_FUNCTION (centerFrequency << txPowerW << guardBandwidth);
  uint8_t channelWidth = 22;  // DSSS channels are 22 MHz wide
  double bandBandwidth = 312500;
  Ptr<SpectrumValue> c = Create<SpectrumValue> (GetSpectrumModel (centerFrequency, channelWidth, bandBandwidth, guardBandwidth));

}

Ptr<SpectrumValue>
WifiSpectrumValueHelper::CreateOfdmTxPowerSpectralDensity (uint32_t centerFrequency, uint8_t channelWidth, double txPowerW, double guardBandwidth)
{
  NS_LOG_FUNCTION (centerFrequency << (uint16_t)channelWidth << txPowerW << guardBandwidth);
  double bandBandwidth = 0;
  switch (channelWidth)
    {
    case 20:
      bandBandwidth = 312500;
      break;
    case 10:
      bandBandwidth = 156250;
      break;
    case 5:
      bandBandwidth = 78125;
      break;
    default:
      NS_FATAL_ERROR ("Channel width " << (uint16_t) channelWidth << " should be correctly set.");
      return 0;
    }

  Ptr<SpectrumValue> c = Create<SpectrumValue> (GetSpectrumModel (centerFrequency, channelWidth, bandBandwidth, guardBandwidth));
  uint32_t nGuardBands = static_cast<uint32_t>(((2 * guardBandwidth * 1e6) / bandBandwidth) + 0.5);
  uint32_t nAllocatedBands = static_cast<uint32_t>(((channelWidth * 1e6) / bandBandwidth) + 0.5);
  NS_ASSERT_MSG (c->GetSpectrumModel ()->GetNumBands () == (nAllocatedBands + nGuardBands + 1), "Unexpected number of bands " << c->GetSpectrumModel ()->GetNumBands ());
  // 52 subcarriers (48 data + 4 pilot)
  // skip guard band and 6 subbands, then place power in 26 subbands, then
  // skip the center subband, then place power in 26 subbands, then skip
  // the final 6 subbands and the guard band.
  double txPowerPerBand = txPowerW / 52;
  switch (channelWidth)
    {
    case 20:
      // 52 subcarriers (48 data + 4 pilot)
      // skip guard band and 6 subbands, then place power in 26 subbands, then
      // skip the center subband, then place power in 26 subbands, then skip
      // the final 6 subbands and the guard band.
      txPowerPerBand = txPowerW / 52;
      start1 = (nGuardBands / 2) + 6;
      stop1 = start1 + 26 - 1;
      start2 = stop1 + 2;
      stop2 = start2 + 26 - 1;
      break;
    case 10:
      // 28 subcarriers (24 data + 4 pilot)
      // skip guard band and 2 subbands, then place power in 14 subbands, then
      // skip the center subband, then place power in 14 subbands, then skip
      // the final 2 subbands and the guard band.
      txPowerPerBand = txPowerW / 28;
      start1 = (nGuardBands / 2) + 2;
      stop1 = start1 + 14 - 1;
      start2 = stop1 + 2;
      stop2 = start2 + 14 - 1;
      break;
    case 5:
      // 16 subcarriers (12 data + 4 pilot)
      // skip guard band and 2 subbands, then place power in 8 subbands, then
      // skip the center subband, then place power in 8 subbands, then skip
      // the final 2 subbands and the guard.
      txPowerPerBand = txPowerW / 16;
      start1 = (nGuardBands / 2) + 2;
      stop1 = start1 + 8 - 1;
      start2 = stop1 + 2;
      stop2 = start2 + 8 - 1;
      break;
    default:
      NS_FATAL_ERROR ("Channel width should be correctly set.");
      return 0;
    }
  NS_LOG_DEBUG ("Power per band " << txPowerPerBand);
  uint32_t start1 = (nGuardBands / 2) + 6;
  uint32_t stop1 = start1 + 26 - 1;
  uint32_t start2 = stop1 + 2;
  uint32_t stop2 = start2 + 26 - 1;
  Values::iterator vit = c->ValuesBegin ();
  Bands::const_iterator bit = c->ConstBandsBegin ();
  for (size_t i = 0; i < c->GetSpectrumModel ()->GetNumBands (); i++, vit++, bit++)

}

Ptr<SpectrumValue>
WifiSpectrumValueHelper::CreateHtOfdmTxPowerSpectralDensity (uint32_t centerFrequency, uint8_t channelWidth, double txPowerW, double guardBandwidth)
{
  NS_LOG_FUNCTION (centerFrequency << (uint16_t)channelWidth << txPowerW << guardBandwidth);
  double bandBandwidth = 312500;
  Ptr<SpectrumValue> c = Create<SpectrumValue> (GetSpectrumModel (centerFrequency, channelWidth, bandBandwidth, guardBandwidth));
  Values::iterator vit = c->ValuesBegin ();

}

Ptr<SpectrumValue>
WifiSpectrumValueHelper::CreateHeOfdmTxPowerSpectralDensity (uint32_t centerFrequency, uint8_t channelWidth, double txPowerW, double guardBandwidth)
{
  NS_LOG_FUNCTION (centerFrequency << (uint16_t)channelWidth << txPowerW << guardBandwidth);
  double bandBandwidth = 78125;
  Ptr<SpectrumValue> c = Create<SpectrumValue> (GetSpectrumModel (centerFrequency, channelWidth, bandBandwidth, guardBandwidth));
  Values::iterator vit = c->ValuesBegin ();

}

Ptr<SpectrumValue>
WifiSpectrumValueHelper::CreateNoisePowerSpectralDensity (uint32_t centerFrequency, uint8_t channelWidth, double bandBandwidth, double noiseFigure, double guardBandwidth)
{
  Ptr<SpectrumModel> model = GetSpectrumModel (centerFrequency, channelWidth, bandBandwidth, guardBandwidth);
  return CreateNoisePowerSpectralDensity (noiseFigure, model);

}

Ptr<SpectrumValue>
WifiSpectrumValueHelper::CreateRfFilter (uint32_t centerFrequency, uint8_t channelWidth, double bandGranularity, double guardBandwidth)
{
  NS_LOG_FUNCTION (centerFrequency << (uint16_t)channelWidth << bandGranularity << guardBandwidth);
  Ptr<SpectrumValue> c = Create <SpectrumValue> (GetSpectrumModel (centerFrequency, channelWidth, bandGranularity, guardBandwidth));
  size_t numBands = c->GetSpectrumModel ()->GetNumBands ();
  Bands::const_iterator bit = c->ConstBandsBegin ();

(-)a/src/spectrum/model/wifi-spectrum-value-helper.h (-9 / +13 lines)

Lines 43-50	Link Here

/**

/**

   * Return a SpectrumModel instance corresponding to the center frequency

   * Return a SpectrumModel instance corresponding to the center frequency

   * and channel width.  The model includes +/- 10 MHz of guard bands

   * and channel width.  The spectrum model spans the channel width

   * (i.e. the model will span (channelWidth + 20) MHz of bandwidth).

   * +/- the guard bands (i.e. the model will span (channelWidth +

   * 2 * guardBandwidth) MHz of bandwidth).

   * \param centerFrequency center frequency (MHz)

   * \param centerFrequency center frequency (MHz)

   * \param channelWidth channel width (MHz)

   * \param channelWidth channel width (MHz)

Lines 54-60	Link Here

   * \return the static SpectrumModel instance corresponding to the

   * \return the static SpectrumModel instance corresponding to the

   * given carrier frequency and channel width configuration.

   * given carrier frequency and channel width configuration.

*/

*/

  static Ptr<SpectrumModel> GetSpectrumModel (uint32_t centerFrequency, uint8_t channelWidth, double bandBandwidth, uint8_t guardBandwidth);

  static Ptr<SpectrumModel> GetSpectrumModel (uint32_t centerFrequency, uint8_t channelWidth, double bandBandwidth, double guardBandwidth);

/**

/**

   * Create a transmit power spectral density corresponding to DSSS

   * Create a transmit power spectral density corresponding to DSSS

Lines 62-77	Link Here

   * The center frequency typically corresponds to 802.11b channel

   * The center frequency typically corresponds to 802.11b channel

   * center frequencies but is not restricted to those frequencies.

   * center frequencies but is not restricted to those frequencies.

   * \note There is no channel width parameter; this method assumes 22 MHz

   * \param centerFrequency center frequency (MHz)

   * \param centerFrequency center frequency (MHz)

   * \param txPowerW  transmit power (W) to allocate

   * \param txPowerW  transmit power (W) to allocate

   * \param guardBandwidth width of the guard band (MHz)

   * \param guardBandwidth width of the guard band (MHz)

   * \returns a pointer to a newly allocated SpectrumValue representing the DSSS Transmit Power Spectral Density in W/Hz

   * \returns a pointer to a newly allocated SpectrumValue representing the DSSS Transmit Power Spectral Density in W/Hz

*/

*/

  static Ptr<SpectrumValue> CreateDsssTxPowerSpectralDensity (uint32_t centerFrequency, double txPowerW, uint8_t guardBandwidth);

  static Ptr<SpectrumValue> CreateDsssTxPowerSpectralDensity (uint32_t centerFrequency, double txPowerW, double guardBandwidth);

/**

/**

   * Create a transmit power spectral density corresponding to OFDM

   * Create a transmit power spectral density corresponding to OFDM

   * (802.11a/g).  Channel width may vary between 20, 10, and 5 MHz.

   * (802.11a/g).  Channel width may vary between 20, 10, and 5 MHz.

   * Guard bandwidth also typically varies with channel width.

   * \param centerFrequency center frequency (MHz)

   * \param centerFrequency center frequency (MHz)

   * \param channelWidth channel width (MHz)

   * \param channelWidth channel width (MHz)

Lines 79-85	Link Here

   * \param guardBandwidth width of the guard band (MHz)

   * \param guardBandwidth width of the guard band (MHz)

   * \return a pointer to a newly allocated SpectrumValue representing the OFDM Transmit Power Spectral Density in W/Hz for each Band

   * \return a pointer to a newly allocated SpectrumValue representing the OFDM Transmit Power Spectral Density in W/Hz for each Band

*/

*/

  static Ptr<SpectrumValue> CreateOfdmTxPowerSpectralDensity (uint32_t centerFrequency, uint8_t channelWidth, double txPowerW, uint8_t guardBandwidth);

  static Ptr<SpectrumValue> CreateOfdmTxPowerSpectralDensity (uint32_t centerFrequency, uint8_t channelWidth, double txPowerW, double guardBandwidth);

/**

/**

   * Create a transmit power spectral density corresponding to OFDM

   * Create a transmit power spectral density corresponding to OFDM

Lines 92-98	Link Here

   * \param guardBandwidth width of the guard band (MHz)

   * \param guardBandwidth width of the guard band (MHz)

   * \return a pointer to a newly allocated SpectrumValue representing the HT OFDM Transmit Power Spectral Density in W/Hz for each Band

   * \return a pointer to a newly allocated SpectrumValue representing the HT OFDM Transmit Power Spectral Density in W/Hz for each Band

*/

*/

  static Ptr<SpectrumValue> CreateHtOfdmTxPowerSpectralDensity (uint32_t centerFrequency, uint8_t channelWidth, double txPowerW, uint8_t guardBandwidth);

  static Ptr<SpectrumValue> CreateHtOfdmTxPowerSpectralDensity (uint32_t centerFrequency, uint8_t channelWidth, double txPowerW, double guardBandwidth);

100

/**

101

/**

   * Create a transmit power spectral density corresponding to OFDM

102

   * Create a transmit power spectral density corresponding to OFDM

Lines 105-111	Link Here

105

   * \param guardBandwidth width of the guard band (MHz)

109

   * \param guardBandwidth width of the guard band (MHz)

106

   * \return a pointer to a newly allocated SpectrumValue representing the HE OFDM Transmit Power Spectral Density in W/Hz for each Band

110

   * \return a pointer to a newly allocated SpectrumValue representing the HE OFDM Transmit Power Spectral Density in W/Hz for each Band

107

*/

111

*/

108

  static Ptr<SpectrumValue> CreateHeOfdmTxPowerSpectralDensity (uint32_t centerFrequency, uint8_t channelWidth, double txPowerW, uint8_t guardBandwidth);

112

  static Ptr<SpectrumValue> CreateHeOfdmTxPowerSpectralDensity (uint32_t centerFrequency, uint8_t channelWidth, double txPowerW, double guardBandwidth);

109

113

110

/**

114

/**

111

   * Create a power spectral density corresponding to the noise

115

   * Create a power spectral density corresponding to the noise

Lines 117-123	Link Here

117

   * \param guardBandwidth width of the guard band (MHz)

121

   * \param guardBandwidth width of the guard band (MHz)

118

   * \return a pointer to a newly allocated SpectrumValue representing the noise Power Spectral Density in W/Hz for each Band

122

   * \return a pointer to a newly allocated SpectrumValue representing the noise Power Spectral Density in W/Hz for each Band

119

*/

123

*/

120

  static Ptr<SpectrumValue> CreateNoisePowerSpectralDensity (uint32_t centerFrequency, uint8_t channelWidth, double bandBandwidth, double noiseFigure, uint8_t guardBandwidth);

124

  static Ptr<SpectrumValue> CreateNoisePowerSpectralDensity (uint32_t centerFrequency, uint8_t channelWidth, double bandBandwidth, double noiseFigure, double guardBandwidth);

121

125

122

/**

126

/**

123

   * Create a thermal noise power spectral density

127

   * Create a thermal noise power spectral density

Lines 139-145	Link Here

139

   * \return a pointer to a SpectrumValue representing the RF filter applied

143

   * \return a pointer to a SpectrumValue representing the RF filter applied

140

   * to an received power spectral density

144

   * to an received power spectral density

141

*/

145

*/

142

  static Ptr<SpectrumValue> CreateRfFilter (uint32_t centerFrequency, uint8_t channelWidth, double bandBandwidth, uint8_t guardBandwidth);

146

  static Ptr<SpectrumValue> CreateRfFilter (uint32_t centerFrequency, uint8_t channelWidth, double bandBandwidth, double guardBandwidth);

143

};

147

};

144

148

145

/**

149

/**





#include "spectrum-wifi-phy.h"
#include "ns3/wifi-spectrum-value-helper.h"
#include "ns3/abort.h"
#include "ns3/log.h"
#include "ns3/boolean.h"
#include "wifi-spectrum-signal-parameters.h"

      break;
    case WIFI_MOD_CLASS_DSSS:
    case WIFI_MOD_CLASS_HR_DSSS:
      NS_ABORT_MSG_IF (channelWidth != 22, "Invalid channel width for DSSS");
      v = WifiSpectrumValueHelper::CreateDsssTxPowerSpectralDensity (centerFrequency, txPowerW, GetGuardBandwidth ());
      break;
    case WIFI_MOD_CLASS_HT:

    case WIFI_PHY_STANDARD_80211a:
    case WIFI_PHY_STANDARD_80211g:
    case WIFI_PHY_STANDARD_holland:
    case WIFI_PHY_STANDARD_80211_10MHZ:
    case WIFI_PHY_STANDARD_80211_5MHZ:
    case WIFI_PHY_STANDARD_80211b:
    case WIFI_PHY_STANDARD_80211n_2_4GHZ:
    case WIFI_PHY_STANDARD_80211n_5GHZ:

      // Use OFDM subcarrier width of 312.5 KHz as band granularity
      bandBandwidth = 312500;
      break;
    case WIFI_PHY_STANDARD_80211_10MHZ:
      // Use OFDM subcarrier width of 156.25 KHz as band granularity
      bandBandwidth = 156250;
      break;
    case WIFI_PHY_STANDARD_80211_5MHZ:
      // Use OFDM subcarrier width of 78.125 KHz as band granularity
      bandBandwidth = 78125;
      break;
    case WIFI_PHY_STANDARD_80211ax_2_4GHZ:
    case WIFI_PHY_STANDARD_80211ax_5GHZ:
      // Use OFDM subcarrier width of 78.125 KHz as band granularity

  return bandBandwidth;
}

double
SpectrumWifiPhy::GetGuardBandwidth (void) const
{
  double guardBandwidth = 0;

    case WIFI_PHY_STANDARD_80211a:
    case WIFI_PHY_STANDARD_80211g:
    case WIFI_PHY_STANDARD_holland:
    case WIFI_PHY_STANDARD_80211_10MHZ:
    case WIFI_PHY_STANDARD_80211_5MHZ:
    case WIFI_PHY_STANDARD_80211b:
    case WIFI_PHY_STANDARD_80211n_2_4GHZ:
    case WIFI_PHY_STANDARD_80211n_5GHZ:
    case WIFI_PHY_STANDARD_80211ac:
    case WIFI_PHY_STANDARD_80211ax_2_4GHZ:
    case WIFI_PHY_STANDARD_80211ax_5GHZ:
      // Use 10 MHZ as per Table D-6 802.11-2016, class A, -10 dB f2 mask point 
      guardBandwidth = 10;
      break;
    case WIFI_PHY_STANDARD_80211_10MHZ:
      // Use 5 MHz as per Table D-5 802.11-2016, class A, -10 dB f2 mask point
      guardBandwidth = 5;
      break;
    case WIFI_PHY_STANDARD_80211_5MHZ:
      // Use 2.5 MHz as per Table D-4 802.11-2016, class A, -10 dB f2 mask point
      guardBandwidth = 2.5;
      break;
    default:
      NS_FATAL_ERROR ("Standard unknown: " << GetStandard ());
      break;

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

Lines 155-161	Link Here

155

/**

155

/**

156

   * \return the width of the guard band (MHz)

156

   * \return the width of the guard band (MHz)

157

*/

157

*/

158

  uint32_t GetGuardBandwidth (void) const;

158

  double GetGuardBandwidth (void) const;

159

160

/**

160

/**

161

   * Callback invoked when the Phy model starts to process a signal

161

   * Callback invoked when the Phy model starts to process a signal

Return to bug 2813