satellite-frame-symbol-load-probe.cc
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2011 Bucknell University
4  * Copyright (c) 2014 Magister Solutions
5  *
6  * This program is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License version 2 as
8  * published by the Free Software Foundation;
9  *
10  * This program is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13  * GNU General Public License for more details.
14  *
15  * You should have received a copy of the GNU General Public License
16  * along with this program; if not, write to the Free Software
17  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
18  *
19  * Authors of original work (application-packet-probe.cc) which this work
20  * derives from:
21  * - L. Felipe Perrone (perrone@bucknell.edu)
22  * - Tiago G. Rodrigues (tgr002@bucknell.edu)
23  * - Mitch Watrous (watrous@u.washington.edu)
24  *
25  * Modified for FrameUtLoadTrace trace source by:
26  * - Budiarto Herman (budiarto.herman@magister.fi)
27  */
28 
29 #include "ns3/satellite-frame-symbol-load-probe.h"
30 
31 #include "ns3/callback.h"
32 #include "ns3/config.h"
33 #include "ns3/log.h"
34 #include "ns3/names.h"
35 #include "ns3/simulator.h"
36 
37 NS_LOG_COMPONENT_DEFINE("SatFrameSymbolLoadProbe");
38 
39 namespace ns3
40 {
41 
42 NS_OBJECT_ENSURE_REGISTERED(SatFrameSymbolLoadProbe);
43 
44 TypeId
46 {
47  static TypeId tid =
48  TypeId("ns3::SatFrameSymbolLoadProbe")
49  .SetParent<Probe>()
50  .AddConstructor<SatFrameSymbolLoadProbe>()
51  .AddTraceSource("Output",
52  "The frame ID and the ratio of allocated symbols that serve as the "
53  "output for this probe",
54  MakeTraceSourceAccessor(&SatFrameSymbolLoadProbe::m_output),
55  "ns3::SatFrameSymbolLoadProbe::FrameSymbolLoadCallback");
56  return tid;
57 }
58 
60 {
61  NS_LOG_FUNCTION(this);
62 }
63 
65 {
66  NS_LOG_FUNCTION(this);
67 }
68 
69 void
70 SatFrameSymbolLoadProbe::SetValue(uint32_t frameId, double loadRatio)
71 {
72  NS_LOG_FUNCTION(this << frameId << loadRatio);
73  m_output(frameId, loadRatio);
74 }
75 
76 void
77 SatFrameSymbolLoadProbe::SetValueByPath(std::string path, uint32_t frameId, double loadRatio)
78 {
79  NS_LOG_FUNCTION(path << frameId << loadRatio);
80  Ptr<SatFrameSymbolLoadProbe> probe = Names::Find<SatFrameSymbolLoadProbe>(path);
81  NS_ASSERT_MSG(probe, "Error: Can't find probe for path " << path);
82  probe->SetValue(frameId, loadRatio);
83 }
84 
85 bool
86 SatFrameSymbolLoadProbe::ConnectByObject(std::string traceSource, Ptr<Object> obj)
87 {
88  NS_LOG_FUNCTION(this << traceSource << obj);
89  NS_LOG_DEBUG("Name of probe (if any) in names database: " << Names::FindPath(obj));
90  bool connected = obj->TraceConnectWithoutContext(
91  traceSource,
92  MakeCallback(&ns3::SatFrameSymbolLoadProbe::TraceSink, this));
93  return connected;
94 }
95 
96 void
98 {
99  NS_LOG_FUNCTION(this << path);
100  NS_LOG_DEBUG("Name of probe to search for in config database: " << path);
101  Config::ConnectWithoutContext(path,
102  MakeCallback(&ns3::SatFrameSymbolLoadProbe::TraceSink, this));
103 }
104 
105 void
106 SatFrameSymbolLoadProbe::TraceSink(uint32_t frameId, double loadRatio)
107 {
108  NS_LOG_FUNCTION(this << frameId << loadRatio);
109  if (IsEnabled())
110  {
111  m_output(frameId, loadRatio);
112  }
113 }
114 
115 } // namespace ns3
void TraceSink(uint32_t frameId, double loadRatio)
Method to connect to an underlying ns3::TraceSource with arguments of type double and const Address&.
virtual bool ConnectByObject(std::string traceSource, Ptr< Object > obj)
connect to a trace source attribute provided by a given object
static TypeId GetTypeId()
Get the type ID.
virtual void ConnectByPath(std::string path)
connect to a trace source provided by a config path
virtual ~SatFrameSymbolLoadProbe()
Destructor for SatFrameSymbolLoadProbe.
void SetValue(uint32_t frameId, double loadRatio)
Set a probe value.
TracedCallback< uint32_t, double > m_output
Output trace, the frame ID and ratio of allocated symbols.
static void SetValueByPath(std::string path, uint32_t frameId, double loadRatio)
Set a probe value by its name in the Config system.
SatArqSequenceNumber is handling the sequence numbers for the ARQ process.