A Discrete-Event Network Simulator
API
spectrum-wifi-phy.h
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2005,2006 INRIA
4  *
5  * This program is free software; you can redistribute it and/or modify
6  * it under the terms of the GNU General Public License version 2 as
7  * published by the Free Software Foundation;
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software
16  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17  *
18  * Authors: Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
19  * Ghada Badawy <gbadawy@gmail.com>
20  * Sébastien Deronne <sebastien.deronne@gmail.com>
21  *
22  * Ported from yans-wifi-phy.h by several contributors starting
23  * with Nicola Baldo and Dean Armstrong
24  */
25 
26 #ifndef SPECTRUM_WIFI_PHY_H
27 #define SPECTRUM_WIFI_PHY_H
28 
29 #include "ns3/antenna-model.h"
30 #include "ns3/spectrum-channel.h"
31 #include "ns3/spectrum-model.h"
32 #include "wifi-phy.h"
33 
34 namespace ns3 {
35 
36 class WifiSpectrumPhyInterface;
37 
50 class SpectrumWifiPhy : public WifiPhy
51 {
52 public:
57  static TypeId GetTypeId (void);
58 
59  SpectrumWifiPhy ();
60  virtual ~SpectrumWifiPhy ();
61 
74  void AddOperationalChannel (uint8_t channelNumber);
82  std::vector<uint8_t> GetOperationalChannelList (void) const;
86  void ClearOperationalChannelList (void);
87 
94  void StartRx (Ptr<SpectrumSignalParameters> rxParams);
95 
103  void StartTx (Ptr<Packet> packet, WifiTxVector txVector, Time txDuration);
112  uint16_t GetCenterFrequencyForChannelWidth (WifiTxVector txVector) const;
113 
133  void SetAntenna (const Ptr<AntennaModel> antenna);
139  Ptr<AntennaModel> GetRxAntenna (void) const;
146 
150  double GetBandBandwidth (void) const;
151 
163  uint16_t GetGuardBandwidth (uint16_t currentChannelWidth) const;
164 
173  typedef void (* SignalArrivalCallback) (bool signalType, uint32_t senderNodeId, double rxPower, Time duration);
174 
175  Ptr<Channel> GetChannel (void) const;
176 
177  // The following four methods call to the base WifiPhy class method
178  // but also generate a new SpectrumModel if called during runtime
179 
180  virtual void SetChannelNumber (uint8_t id);
181 
182  virtual void SetFrequency (uint16_t freq);
183 
184  virtual void SetChannelWidth (uint16_t channelwidth);
185 
186  virtual void ConfigureStandard (WifiPhyStandard standard);
187 
188 protected:
189  // Inherited
190  void DoDispose (void);
191  void DoInitialize (void);
192 
193 
194 private:
205  Ptr<SpectrumValue> GetTxPowerSpectralDensity (uint16_t centerFrequency, uint16_t channelWidth, double txPowerW, WifiModulationClass modulationClass) const;
206 
210  void ResetSpectrumModel (void);
211 
213  std::vector<uint8_t> m_operationalChannelList;
214 
220 
221 };
222 
223 } //namespace ns3
224 
225 #endif /* SPECTRUM_WIFI_PHY_H */
uint16_t GetGuardBandwidth(uint16_t currentChannelWidth) const
Simulation virtual time values and global simulation resolution.
Definition: nstime.h:102
TracedCallback< bool, uint32_t, double, Time > m_signalCb
Signal callback.
Smart pointer class similar to boost::intrusive_ptr.
Definition: ptr.h:73
This class mimics the TXVECTOR which is to be passed to the PHY in order to define the parameters whi...
std::vector< uint8_t > GetOperationalChannelList(void) const
Return a list of channels to which it may be possible to roam By default, this method will return the...
void StartRx(Ptr< SpectrumSignalParameters > rxParams)
Input method for delivering a signal from the spectrum channel and low-level Phy interface to this Sp...
802.11 PHY layer model
Definition: wifi-phy.h:64
Forward calls to a chain of Callback.
void StartTx(Ptr< Packet > packet, WifiTxVector txVector, Time txDuration)
static TypeId GetTypeId(void)
Get the type ID.
bool m_disableWifiReception
forces this Phy to fail to sync on any signal
void SetAntenna(const Ptr< AntennaModel > antenna)
virtual void SetChannelNumber(uint8_t id)
Set channel number.
Ptr< const SpectrumModel > GetRxSpectrumModel() const
void(* SignalArrivalCallback)(bool signalType, uint32_t senderNodeId, double rxPower, Time duration)
Callback invoked when the Phy model starts to process a signal.
void DoInitialize(void)
Initialize() implementation.
channel
Definition: third.py:85
double GetBandBandwidth(void) const
Ptr< SpectrumChannel > m_channel
SpectrumChannel that this SpectrumWifiPhy is connected to.
Ptr< SpectrumValue > GetTxPowerSpectralDensity(uint16_t centerFrequency, uint16_t channelWidth, double txPowerW, WifiModulationClass modulationClass) const
WifiPhyStandard
Identifies the PHY specification that a Wifi device is configured to use.
virtual void ConfigureStandard(WifiPhyStandard standard)
Configure the PHY-level parameters for different Wi-Fi standard.
void DoDispose(void)
Destructor implementation.
802.11 PHY layer modelThis PHY implements a spectrum-aware enhancement of the 802.11 SpectrumWifiPhy model.
Ptr< const SpectrumModel > m_rxSpectrumModel
receive spectrum model
virtual void SetFrequency(uint16_t freq)
Every class exported by the ns3 library is enclosed in the ns3 namespace.
virtual void SetChannelWidth(uint16_t channelwidth)
WifiModulationClass
This enumeration defines the modulation classes per (Table 9-4 "Modulation classes"; IEEE 802...
Definition: wifi-mode.h:36
Ptr< AntennaModel > GetRxAntenna(void) const
Get the antenna model used for reception.
Ptr< AntennaModel > m_antenna
antenna model
std::vector< uint8_t > m_operationalChannelList
List of possible channels.
uint16_t GetCenterFrequencyForChannelWidth(WifiTxVector txVector) const
Get the center frequency of the channel corresponding the current TxVector rather than that of the su...
void ClearOperationalChannelList(void)
Clear the list of operational channels.
Ptr< WifiSpectrumPhyInterface > m_wifiSpectrumPhyInterface
Spectrum phy interface.
void ResetSpectrumModel(void)
Perform run-time spectrum model change.
void AddOperationalChannel(uint8_t channelNumber)
Add a channel number to the list of operational channels.
Ptr< Channel > GetChannel(void) const
Return the Channel this WifiPhy is connected to.
void SetChannel(const Ptr< SpectrumChannel > channel)
Set the SpectrumChannel this SpectrumWifiPhy is to be connected to.
a unique identifier for an interface.
Definition: type-id.h:58
void CreateWifiSpectrumPhyInterface(Ptr< NetDevice > device)
Method to encapsulate the creation of the WifiSpectrumPhyInterface object (used to bind the WifiSpect...