A Discrete-Event Network Simulator
API
yans-wifi-phy.cc
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2005,2006 INRIA
3  *
4  * This program is free software; you can redistribute it and/or modify
5  * it under the terms of the GNU General Public License version 2 as
6  * published by the Free Software Foundation;
7  *
8  * This program is distributed in the hope that it will be useful,
9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11  * GNU General Public License for more details.
12  *
13  * You should have received a copy of the GNU General Public License
14  * along with this program; if not, write to the Free Software
15  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
16  *
17  * Authors: Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
18  * Ghada Badawy <gbadawy@gmail.com>
19  * Sébastien Deronne <sebastien.deronne@gmail.com>
20  */
21 
22 #include "yans-wifi-phy.h"
23 
24 #include "interference-helper.h"
25 #include "yans-wifi-channel.h"
26 
27 #include "ns3/log.h"
28 
29 namespace ns3
30 {
31 
32 NS_LOG_COMPONENT_DEFINE("YansWifiPhy");
33 
34 NS_OBJECT_ENSURE_REGISTERED(YansWifiPhy);
35 
36 TypeId
38 {
39  static TypeId tid = TypeId("ns3::YansWifiPhy")
40  .SetParent<WifiPhy>()
41  .SetGroupName("Wifi")
42  .AddConstructor<YansWifiPhy>();
43  return tid;
44 }
45 
47 {
48  NS_LOG_FUNCTION(this);
49 }
50 
51 void
53 {
55  // add dummy band for Yans
56  WifiSpectrumBand band;
57  band.first = 0;
58  band.second = 0;
59  m_interference->AddBand(band);
60 }
61 
63 {
64  NS_LOG_FUNCTION(this);
65 }
66 
67 void
69 {
70  NS_LOG_FUNCTION(this);
71  m_channel = nullptr;
73 }
74 
77 {
78  return m_channel;
79 }
80 
81 void
83 {
84  NS_LOG_FUNCTION(this << channel);
86  m_channel->Add(this);
87 }
88 
89 void
91 {
92  NS_LOG_FUNCTION(this << ppdu);
93  NS_LOG_DEBUG("Start transmission: signal power before antenna gain="
94  << GetPowerDbm(ppdu->GetTxVector().GetTxPowerLevel()) << "dBm");
95  m_channel->Send(this, ppdu, GetTxPowerForTransmission(ppdu) + GetTxGain());
96 }
97 
98 uint16_t
99 YansWifiPhy::GetGuardBandwidth(uint16_t currentChannelWidth) const
100 {
101  NS_ABORT_MSG("Guard bandwidth not relevant for Yans");
102  return 0;
103 }
104 
105 std::tuple<double, double, double>
107 {
108  NS_ABORT_MSG("Tx mask rejection params not relevant for Yans");
109  return std::make_tuple(0.0, 0.0, 0.0);
110 }
111 
112 } // namespace ns3
Smart pointer class similar to boost::intrusive_ptr.
Definition: ptr.h:78
a unique identifier for an interface.
Definition: type-id.h:60
TypeId SetParent(TypeId tid)
Set the parent TypeId.
Definition: type-id.cc:935
802.11 PHY layer model
Definition: wifi-phy.h:53
virtual void SetInterferenceHelper(const Ptr< InterferenceHelper > helper)
Sets the interference helper.
Definition: wifi-phy.cc:624
double GetTxGain() const
Return the transmission gain (dB).
Definition: wifi-phy.cc:568
double GetPowerDbm(uint8_t power) const
Get the power of the given power level in dBm.
Definition: wifi-phy.cc:664
void DoDispose() override
Destructor implementation.
Definition: wifi-phy.cc:392
Ptr< InterferenceHelper > m_interference
Pointer to a helper responsible for interference computations.
Definition: wifi-phy.h:1206
double GetTxPowerForTransmission(Ptr< const WifiPpdu > ppdu) const
Compute the transmit power for the next transmission.
Definition: wifi-phy.cc:2132
802.11 PHY layer model
Definition: yans-wifi-phy.h:48
Ptr< YansWifiChannel > m_channel
YansWifiChannel that this YansWifiPhy is connected to.
Definition: yans-wifi-phy.h:76
void StartTx(Ptr< const WifiPpdu > ppdu) override
uint16_t GetGuardBandwidth(uint16_t currentChannelWidth) const override
void SetChannel(const Ptr< YansWifiChannel > channel)
Set the YansWifiChannel this YansWifiPhy is to be connected to.
std::tuple< double, double, double > GetTxMaskRejectionParams() const override
~YansWifiPhy() override
void SetInterferenceHelper(const Ptr< InterferenceHelper > helper) override
Sets the interference helper.
Ptr< Channel > GetChannel() const override
Return the Channel this WifiPhy is connected to.
void DoDispose() override
Destructor implementation.
static TypeId GetTypeId()
Get the type ID.
#define NS_ABORT_MSG(msg)
Unconditional abnormal program termination with a message.
Definition: abort.h:49
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Definition: log.h:202
#define NS_LOG_DEBUG(msg)
Use NS_LOG to output a message of level LOG_DEBUG.
Definition: log.h:268
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by ",...
#define NS_OBJECT_ENSURE_REGISTERED(type)
Register an Object subclass with the TypeId system.
Definition: object-base.h:46
Every class exported by the ns3 library is enclosed in the ns3 namespace.
std::pair< uint32_t, uint32_t > WifiSpectrumBand
typedef for a pair of start and stop sub-band indexes
channel
Definition: third.py:81