A Discrete-Event Network Simulator
API
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
athstats-helper.cc
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2009 CTTC
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: Nicola Baldo <nbaldo@cttc.es>
19  */
20 
21 #include "ns3/log.h"
22 #include "ns3/assert.h"
23 #include "ns3/abort.h"
24 #include "ns3/simulator.h"
25 #include "ns3/nstime.h"
26 #include "ns3/config.h"
27 #include "athstats-helper.h"
28 #include <iomanip>
29 #include <iostream>
30 #include <fstream>
31 
32 
33 NS_LOG_COMPONENT_DEFINE ("Athstats");
34 
35 namespace ns3 {
36 
37 
39  : m_interval (Seconds (1.0))
40 {
41 }
42 
43 void
44 AthstatsHelper::EnableAthstats (std::string filename, uint32_t nodeid, uint32_t deviceid)
45 {
46  Ptr<AthstatsWifiTraceSink> athstats = CreateObject<AthstatsWifiTraceSink> ();
47  std::ostringstream oss;
48  oss << filename
49  << "_" << std::setfill ('0') << std::setw (3) << std::right << nodeid
50  << "_" << std::setfill ('0') << std::setw (3) << std::right << deviceid;
51  athstats->Open (oss.str ());
52 
53  oss.str ("");
54  oss << "/NodeList/" << nodeid << "/DeviceList/" << deviceid;
55  std::string devicepath = oss.str ();
56 
57  Config::Connect (devicepath + "/Mac/MacTx", MakeCallback (&AthstatsWifiTraceSink::DevTxTrace, athstats));
58  Config::Connect (devicepath + "/Mac/MacRx", MakeCallback (&AthstatsWifiTraceSink::DevRxTrace, athstats));
59 
60  Config::Connect (devicepath + "/RemoteStationManager/TxRtsFailed", MakeCallback (&AthstatsWifiTraceSink::TxRtsFailedTrace, athstats));
61  Config::Connect (devicepath + "/RemoteStationManager/MacTxDataFailed", MakeCallback (&AthstatsWifiTraceSink::TxDataFailedTrace, athstats));
62  Config::Connect (devicepath + "/RemoteStationManager/MacTxFinalRtsFailed", MakeCallback (&AthstatsWifiTraceSink::TxFinalRtsFailedTrace, athstats));
63  Config::Connect (devicepath + "/RemoteStationManager/MacTxFinalDataFailed", MakeCallback (&AthstatsWifiTraceSink::TxFinalDataFailedTrace, athstats));
64 
65  Config::Connect (devicepath + "/Phy/State/RxOk", MakeCallback (&AthstatsWifiTraceSink::PhyRxOkTrace, athstats));
66  Config::Connect (devicepath + "/Phy/State/RxError", MakeCallback (&AthstatsWifiTraceSink::PhyRxErrorTrace, athstats));
67  Config::Connect (devicepath + "/Phy/State/Tx", MakeCallback (&AthstatsWifiTraceSink::PhyTxTrace, athstats));
68  Config::Connect (devicepath + "/Phy/State/State", MakeCallback (&AthstatsWifiTraceSink::PhyStateTrace, athstats));
69 }
70 
71 void
73 {
74  EnableAthstats (filename, nd->GetNode ()->GetId (), nd->GetIfIndex ());
75 }
76 
77 
78 void
80 {
81  for (NetDeviceContainer::Iterator i = d.Begin (); i != d.End (); ++i)
82  {
83  Ptr<NetDevice> dev = *i;
84  EnableAthstats (filename, dev->GetNode ()->GetId (), dev->GetIfIndex ());
85  }
86 }
87 
88 
89 void
91 {
92  NetDeviceContainer devs;
93  for (NodeContainer::Iterator i = n.Begin (); i != n.End (); ++i)
94  {
95  Ptr<Node> node = *i;
96  for (uint32_t j = 0; j < node->GetNDevices (); ++j)
97  {
98  devs.Add (node->GetDevice (j));
99  }
100  }
101  EnableAthstats (filename, devs);
102 }
103 
104 
105 
106 
107 
109 
110 TypeId
112 {
113  static TypeId tid = TypeId ("ns3::AthstatsWifiTraceSink")
114  .SetParent<Object> ()
115  .AddConstructor<AthstatsWifiTraceSink> ()
116  .AddAttribute ("Interval",
117  "Time interval between reports",
118  TimeValue (Seconds (1.0)),
119  MakeTimeAccessor (&AthstatsWifiTraceSink::m_interval),
120  MakeTimeChecker ())
121  ;
122  return tid;
123 }
124 
126  : m_txCount (0),
127  m_rxCount (0),
128  m_shortRetryCount (0),
129  m_longRetryCount (0),
130  m_exceededRetryCount (0),
131  m_phyRxOkCount (0),
132  m_phyRxErrorCount (0),
133  m_phyTxCount (0),
134  m_writer (0)
135 {
137 }
138 
140 {
141  NS_LOG_FUNCTION (this);
142 
143  if (m_writer != 0)
144  {
145  NS_LOG_LOGIC ("m_writer nonzero " << m_writer);
146  if (m_writer->is_open ())
147  {
148  NS_LOG_LOGIC ("m_writer open. Closing " << m_writer);
149  m_writer->close ();
150  }
151 
152  NS_LOG_LOGIC ("Deleting writer " << m_writer);
153  delete m_writer;
154 
155  NS_LOG_LOGIC ("m_writer = 0");
156  m_writer = 0;
157  }
158  else
159  {
160  NS_LOG_LOGIC ("m_writer == 0");
161  }
162 }
163 
164 void
166 {
167  m_txCount = 0;
168  m_rxCount = 0;
169  m_shortRetryCount = 0;
170  m_longRetryCount = 0;
172  m_phyRxOkCount = 0;
173  m_phyRxErrorCount = 0;
174  m_phyTxCount = 0;
175 }
176 
177 void
179 {
180  NS_LOG_FUNCTION (this << context << p);
181  ++m_txCount;
182 }
183 
184 void
186 {
187  NS_LOG_FUNCTION (this << context << p);
188  ++m_rxCount;
189 }
190 
191 
192 void
194 {
195  NS_LOG_FUNCTION (this << context << address);
197 }
198 
199 void
201 {
202  NS_LOG_FUNCTION (this << context << address);
204 }
205 
206 void
208 {
209  NS_LOG_FUNCTION (this << context << address);
211 }
212 
213 void
215 {
216  NS_LOG_FUNCTION (this << context << address);
218 }
219 
220 
221 
222 void
223 AthstatsWifiTraceSink::PhyRxOkTrace (std::string context, Ptr<const Packet> packet, double snr, WifiMode mode, enum WifiPreamble preamble)
224 {
225  NS_LOG_FUNCTION (this << context << packet << " mode=" << mode << " snr=" << snr );
226  ++m_phyRxOkCount;
227 }
228 
229 void
230 AthstatsWifiTraceSink::PhyRxErrorTrace (std::string context, Ptr<const Packet> packet, double snr)
231 {
232  NS_LOG_FUNCTION (this << context << packet << " snr=" << snr );
234 }
235 
236 void
237 AthstatsWifiTraceSink::PhyTxTrace (std::string context, Ptr<const Packet> packet, WifiMode mode, WifiPreamble preamble, uint8_t txPower)
238 {
239  NS_LOG_FUNCTION (this << context << packet << "PHYTX mode=" << mode );
240  ++m_phyTxCount;
241 }
242 
243 
244 void
245 AthstatsWifiTraceSink::PhyStateTrace (std::string context, Time start, Time duration, enum WifiPhy::State state)
246 {
247  NS_LOG_FUNCTION (this << context << start << duration << state);
248 
249 }
250 
251 
252 
253 void
254 AthstatsWifiTraceSink::Open (std::string const &name)
255 {
256  NS_LOG_FUNCTION (this << name);
257  NS_ABORT_MSG_UNLESS (m_writer == 0, "AthstatsWifiTraceSink::Open (): m_writer already allocated (std::ofstream leak detected)");
258 
259  m_writer = new std::ofstream ();
260  NS_ABORT_MSG_UNLESS (m_writer, "AthstatsWifiTraceSink::Open (): Cannot allocate m_writer");
261 
262  NS_LOG_LOGIC ("Created writer " << m_writer);
263 
264  m_writer->open (name.c_str (), std::ios_base::binary | std::ios_base::out);
265  NS_ABORT_MSG_IF (m_writer->fail (), "AthstatsWifiTraceSink::Open (): m_writer->open (" << name.c_str () << ") failed");
266 
267  NS_ASSERT_MSG (m_writer->is_open (), "AthstatsWifiTraceSink::Open (): m_writer not open");
268 
269  NS_LOG_LOGIC ("Writer opened successfully");
270 }
271 
272 
273 void
275 {
276  NS_ABORT_MSG_UNLESS (this, "function called with null this pointer, now=" << Now () );
277  // the comments below refer to how each value maps to madwifi's athstats
278  // I know C strings are ugly but that's the quickest way to use exactly the same format as in madwifi
279  char str[200];
280  snprintf (str, 200, "%8u %8u %7u %7u %7u %6u %6u %6u %7u %4u %3uM\n",
281  (unsigned int) m_txCount, // /proc/net/dev transmitted packets to which we should subract mgmt frames
282  (unsigned int) m_rxCount, // /proc/net/dev received packets but subracts mgmt frames from it
283  (unsigned int) 0, // ast_tx_altrate,
284  (unsigned int) m_shortRetryCount, // ast_tx_shortretry,
285  (unsigned int) m_longRetryCount, // ast_tx_longretry,
286  (unsigned int) m_exceededRetryCount, // ast_tx_xretries,
287  (unsigned int) m_phyRxErrorCount, // ast_rx_crcerr,
288  (unsigned int) 0, // ast_rx_badcrypt,
289  (unsigned int) 0, // ast_rx_phyerr,
290  (unsigned int) 0, // ast_rx_rssi,
291  (unsigned int) 0 // rate
292  );
293 
294  if (m_writer)
295  {
296 
297  *m_writer << str;
298 
299  ResetCounters ();
301  }
302 }
303 
304 
305 
306 
307 } // namespace ns3
308 
309 
Iterator Begin(void) const
Get an iterator which refers to the first NetDevice in the container.
Simulation virtual time values and global simulation resolution.
Definition: nstime.h:79
void PhyRxErrorTrace(std::string context, Ptr< const Packet > packet, double snr)
Function to be called when a frame reception by the PHY layer of the considered device resulted in an...
smart pointer class similar to boost::intrusive_ptr
Definition: ptr.h:60
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by "...
void DevTxTrace(std::string context, Ptr< const Packet > p)
function to be called when the net device transmits a packet
void PhyStateTrace(std::string context, Time start, Time duration, enum WifiPhy::State state)
Function to be called when the PHY layer of the considered device changes state.
void TxFinalRtsFailedTrace(std::string context, Mac48Address address)
Function to be called when the transmission of a RTS frame has exceeded the retry limit...
#define NS_OBJECT_ENSURE_REGISTERED(type)
Register the class in the ns-3 factory.
Definition: object-base.h:38
std::vector< Ptr< Node > >::const_iterator Iterator
Node container iterator.
State
The state of the PHY layer.
Definition: wifi-phy.h:123
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Definition: log.h:170
Iterator End(void) const
Get an iterator which indicates past-the-last Node in the container.
void TxRtsFailedTrace(std::string context, Mac48Address address)
Function to be called when a RTS frame transmission by the considered device has failed.
static EventId Schedule(Time const &time, MEM mem_ptr, OBJ obj)
Schedule an event to expire at the relative time "time" is reached.
Definition: simulator.h:825
void Connect(std::string path, const CallbackBase &cb)
Definition: config.cc:728
represent a single transmission modeA WifiMode is implemented by a single integer which is used to lo...
Definition: wifi-mode.h:91
trace sink for wifi device that mimics madwifi's athstats tool.
WifiPreamble
The type of preamble to be used by an IEEE 802.11 transmission.
Definition: wifi-preamble.h:29
hold objects of type ns3::Time
Definition: nstime.h:1008
void Add(NetDeviceContainer other)
Append the contents of another NetDeviceContainer to the end of this container.
holds a vector of ns3::NetDevice pointers
Ptr< NetDevice > GetDevice(uint32_t index) const
Definition: node.cc:134
Callback< R > MakeCallback(R(T::*memPtr)(void), OBJ objPtr)
Definition: callback.h:1242
#define NS_LOG_LOGIC(msg)
Use NS_LOG to output a message of level LOG_LOGIC.
Definition: log.h:233
uint32_t GetNDevices(void) const
Definition: node.cc:142
void Open(std::string const &name)
Open a file for output.
keep track of a set of node pointers.
Iterator Begin(void) const
Get an iterator which refers to the first Node in the container.
void PhyTxTrace(std::string context, Ptr< const Packet > packet, WifiMode mode, WifiPreamble preamble, uint8_t txPower)
Function to be called when a frame is being transmitted by the PHY layer of the considered device...
an EUI-48 address
Definition: mac48-address.h:41
static EventId ScheduleNow(MEM mem_ptr, OBJ obj)
Schedule an event to expire Now.
Definition: simulator.h:986
void EnableAthstats(std::string filename, uint32_t nodeid, uint32_t deviceid)
#define NS_ASSERT_MSG(condition, message)
At runtime, in debugging builds, if this condition is not true, the program prints the message to out...
Definition: assert.h:84
#define NS_ABORT_MSG_UNLESS(cond, msg)
Abnormal program termination if cond is false.
Definition: abort.h:136
#define NS_ABORT_MSG_IF(cond, msg)
Abnormal program termination if cond is true.
Definition: abort.h:101
Time Now(void)
create an ns3::Time instance which contains the current simulation time.
Definition: simulator.cc:287
std::vector< Ptr< NetDevice > >::const_iterator Iterator
NetDevice container iterator.
Ptr< const AttributeChecker > MakeTimeChecker(const Time min, const Time max)
Helper to make a Time checker with bounded range.
Definition: time.cc:441
void PhyRxOkTrace(std::string context, Ptr< const Packet > packet, double snr, WifiMode mode, enum WifiPreamble preamble)
Function to be called when the PHY layer of the considered device receives a frame.
void TxFinalDataFailedTrace(std::string context, Mac48Address address)
Function to be called when the transmission of a data frame has exceeded the retry limit...
a base class which provides memory management and object aggregation
Definition: object.h:64
tuple address
Definition: first.py:37
void TxDataFailedTrace(std::string context, Mac48Address address)
Function to be called when a data frame transmission by the considered device has failed...
Iterator End(void) const
Get an iterator which indicates past-the-last NetDevice in the container.
a unique identifier for an interface.
Definition: type-id.h:49
TypeId SetParent(TypeId tid)
Definition: type-id.cc:610
void DevRxTrace(std::string context, Ptr< const Packet > p)
function to be called when the net device receives a packet
static TypeId GetTypeId(void)