A Discrete-Event Network Simulator
API
yans-wifi-channel.cc
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2006,2007 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  * Author: Mathieu Lacage, <mathieu.lacage@sophia.inria.fr>
19  */
20 #include "ns3/packet.h"
21 #include "ns3/simulator.h"
22 #include "ns3/mobility-model.h"
23 #include "ns3/net-device.h"
24 #include "ns3/node.h"
25 #include "ns3/log.h"
26 #include "ns3/pointer.h"
27 #include "ns3/object-factory.h"
28 #include "yans-wifi-channel.h"
29 #include "yans-wifi-phy.h"
30 #include "ns3/propagation-loss-model.h"
31 #include "ns3/propagation-delay-model.h"
32 
33 namespace ns3 {
34 
35 NS_LOG_COMPONENT_DEFINE ("YansWifiChannel");
36 
37 NS_OBJECT_ENSURE_REGISTERED (YansWifiChannel);
38 
39 TypeId
41 {
42  static TypeId tid = TypeId ("ns3::YansWifiChannel")
44  .SetGroupName ("Wifi")
45  .AddConstructor<YansWifiChannel> ()
46  .AddAttribute ("PropagationLossModel", "A pointer to the propagation loss model attached to this channel.",
47  PointerValue (),
49  MakePointerChecker<PropagationLossModel> ())
50  .AddAttribute ("PropagationDelayModel", "A pointer to the propagation delay model attached to this channel.",
51  PointerValue (),
53  MakePointerChecker<PropagationDelayModel> ())
54  ;
55  return tid;
56 }
57 
59 {
60 }
62 {
64  m_phyList.clear ();
65 }
66 
67 void
69 {
70  m_loss = loss;
71 }
72 void
74 {
75  m_delay = delay;
76 }
77 
78 void
79 YansWifiChannel::Send (Ptr<YansWifiPhy> sender, Ptr<const Packet> packet, double txPowerDbm,
80  WifiTxVector txVector, WifiPreamble preamble, uint8_t packetType, Time duration) const
81 {
82  Ptr<MobilityModel> senderMobility = sender->GetMobility ()->GetObject<MobilityModel> ();
83  NS_ASSERT (senderMobility != 0);
84  uint32_t j = 0;
85  for (PhyList::const_iterator i = m_phyList.begin (); i != m_phyList.end (); i++, j++)
86  {
87  if (sender != (*i))
88  {
89  // For now don't account for inter channel interference
90  if ((*i)->GetChannelNumber () != sender->GetChannelNumber ())
91  {
92  continue;
93  }
94 
95  Ptr<MobilityModel> receiverMobility = (*i)->GetMobility ()->GetObject<MobilityModel> ();
96  Time delay = m_delay->GetDelay (senderMobility, receiverMobility);
97  double rxPowerDbm = m_loss->CalcRxPower (txPowerDbm, senderMobility, receiverMobility);
98  NS_LOG_DEBUG ("propagation: txPower=" << txPowerDbm << "dbm, rxPower=" << rxPowerDbm << "dbm, " <<
99  "distance=" << senderMobility->GetDistanceFrom (receiverMobility) << "m, delay=" << delay);
100  Ptr<Packet> copy = packet->Copy ();
101  Ptr<Object> dstNetDevice = m_phyList[j]->GetDevice ();
102  uint32_t dstNode;
103  if (dstNetDevice == 0)
104  {
105  dstNode = 0xffffffff;
106  }
107  else
108  {
109  dstNode = dstNetDevice->GetObject<NetDevice> ()->GetNode ()->GetId ();
110  }
111 
112  double *atts = new double[3];
113  *atts = rxPowerDbm;
114  *(atts+1)= packetType;
115  *(atts+2)= duration.GetNanoSeconds();
116 
118  delay, &YansWifiChannel::Receive, this,
119  j, copy, atts, txVector, preamble);
120  }
121  }
122 }
123 
124 void
125 YansWifiChannel::Receive (uint32_t i, Ptr<Packet> packet, double *atts,
126  WifiTxVector txVector, WifiPreamble preamble) const
127 {
128  m_phyList[i]->StartReceivePlcp (packet, *atts, txVector, preamble,*(atts+1), NanoSeconds(*(atts+2)));
129  delete[] atts;
130 }
131 
132 uint32_t
134 {
135  return m_phyList.size ();
136 }
138 YansWifiChannel::GetDevice (uint32_t i) const
139 {
140  return m_phyList[i]->GetDevice ()->GetObject<NetDevice> ();
141 }
142 
143 void
145 {
146  m_phyList.push_back (phy);
147 }
148 
149 int64_t
151 {
152  int64_t currentStream = stream;
153  currentStream += m_loss->AssignStreams (stream);
154  return (currentStream - stream);
155 }
156 
157 } // namespace ns3
Ptr< PropagationDelayModel > m_delay
Propagation delay model.
Simulation virtual time values and global simulation resolution.
Definition: nstime.h:102
uint16_t GetChannelNumber(void) const
Return the current channel number.
This class mimics the TXVECTOR which is to be passed to the PHY in order to define the parameters whi...
double GetDistanceFrom(Ptr< const MobilityModel > position) const
#define NS_OBJECT_ENSURE_REGISTERED(type)
Register an Object subclass with the TypeId system.
Definition: object-base.h:44
int64_t AssignStreams(int64_t stream)
Assign a fixed random variable stream number to the random variables used by this model...
void SetPropagationLossModel(Ptr< PropagationLossModel > loss)
void SetPropagationDelayModel(Ptr< PropagationDelayModel > delay)
#define NS_ASSERT(condition)
At runtime, in debugging builds, if this condition is not true, the program prints the source file...
Definition: assert.h:67
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Definition: log.h:201
#define NS_LOG_FUNCTION_NOARGS()
Output the name of the function.
WifiPreamble
The type of preamble to be used by an IEEE 802.11 transmission.
Definition: wifi-preamble.h:29
Keep track of the current position and velocity of an object.
virtual Ptr< NetDevice > GetDevice(uint32_t i) const
Ptr< const AttributeAccessor > MakePointerAccessor(T1 a1)
Create an AttributeAccessor for a class data member, or a lone class get functor or set method...
Definition: pointer.h:210
Time NanoSeconds(uint64_t value)
Construct a Time in the indicated unit.
Definition: nstime.h:890
virtual uint32_t GetNDevices(void) const
Ptr< PropagationLossModel > m_loss
Propagation loss model.
double CalcRxPower(double txPowerDbm, Ptr< MobilityModel > a, Ptr< MobilityModel > b) const
Returns the Rx Power taking into account all the PropagatinLossModel(s) chained to the current one...
static void ScheduleWithContext(uint32_t context, Time const &time, MEM mem_ptr, OBJ obj)
Schedule an event with the given context.
Definition: simulator.h:899
PhyList m_phyList
List of YansWifiPhys connected to this YansWifiChannel.
Ptr< Packet > Copy(void) const
performs a COW copy of the packet.
Definition: packet.cc:122
Every class exported by the ns3 library is enclosed in the ns3 namespace.
Hold objects of type Ptr.
Definition: pointer.h:36
static TypeId GetTypeId(void)
void Send(Ptr< YansWifiPhy > sender, Ptr< const Packet > packet, double txPowerDbm, WifiTxVector txVector, WifiPreamble preamble, uint8_t packetType, Time duration) const
Wifi Channel interface specificationThis class works in tandem with the ns3::WifiPhy class...
Definition: wifi-channel.h:42
int64_t GetNanoSeconds(void) const
Get an approximation of the time stored in this instance in the indicated unit.
Definition: nstime.h:346
Network layer to device interface.
Definition: net-device.h:75
#define NS_LOG_DEBUG(msg)
Use NS_LOG to output a message of level LOG_DEBUG.
Definition: log.h:236
void Add(Ptr< YansWifiPhy > phy)
Adds the given YansWifiPhy to the PHY list.
A Yans wifi channelThis wifi channel implements the propagation model described in "Yet Another Netwo...
void Receive(uint32_t i, Ptr< Packet > packet, double *atts, WifiTxVector txVector, WifiPreamble preamble) const
This method is scheduled by Send for each associated YansWifiPhy.
Ptr< T > GetObject(void) const
Get a pointer to the requested aggregated Object.
Definition: object.h:455
a unique identifier for an interface.
Definition: type-id.h:57
TypeId SetParent(TypeId tid)
Definition: type-id.cc:638
int64_t AssignStreams(int64_t stream)
If this loss model uses objects of type RandomVariableStream, set the stream numbers to the integers ...
Ptr< Object > GetMobility(void)
Return the mobility model this PHY is associated with.