A Discrete-Event Network Simulator
API
point-to-point-epc-helper.cc
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2011-2019 Centre Tecnologic de Telecomunicacions de Catalunya (CTTC)
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:
18  * Jaume Nin <jnin@cttc.es>
19  * Nicola Baldo <nbaldo@cttc.es>
20  * Manuel Requena <manuel.requena@cttc.es>
21  * (most of the code refactored to no-backhaul-epc-helper.cc)
22  */
23 
25 
26 #include "ns3/boolean.h"
27 #include "ns3/log.h"
28 #include "ns3/point-to-point-helper.h"
29 #include "ns3/string.h"
30 
31 namespace ns3
32 {
33 
34 NS_LOG_COMPONENT_DEFINE("PointToPointEpcHelper");
35 
36 NS_OBJECT_ENSURE_REGISTERED(PointToPointEpcHelper);
37 
40 {
41  NS_LOG_FUNCTION(this);
42  // To access the attribute value within the constructor
44 
45  // since we use point-to-point links for the backhaul links,
46  // we use a /30 subnet which can hold exactly two addresses
47  // (remember that net broadcast and null address are not valid)
48  m_s1uIpv4AddressHelper.SetBase("10.0.0.0", "255.255.255.252");
49  m_s1apIpv4AddressHelper.SetBase("11.0.0.0", "255.255.255.252");
50 }
51 
53 {
54  NS_LOG_FUNCTION(this);
55 }
56 
57 TypeId
59 {
61  static TypeId tid =
62  TypeId("ns3::PointToPointEpcHelper")
64  .SetGroupName("Lte")
65  .AddConstructor<PointToPointEpcHelper>()
66  .AddAttribute("S1uLinkDataRate",
67  "The data rate to be used for the next S1-U link to be created",
68  DataRateValue(DataRate("10Gb/s")),
69  MakeDataRateAccessor(&PointToPointEpcHelper::m_s1uLinkDataRate),
70  MakeDataRateChecker())
71  .AddAttribute("S1uLinkDelay",
72  "The delay to be used for the next S1-U link to be created",
73  TimeValue(Seconds(0)),
76  .AddAttribute("S1uLinkMtu",
77  "The MTU of the next S1-U link to be created. Note that, because of the "
78  "additional GTP/UDP/IP tunneling overhead, you need a MTU larger than "
79  "the end-to-end MTU that you want to support.",
80  UintegerValue(2000),
82  MakeUintegerChecker<uint16_t>())
83  .AddAttribute("S1uLinkPcapPrefix",
84  "Prefix for Pcap generated by S1-U link",
85  StringValue("s1u"),
88  .AddAttribute("S1uLinkEnablePcap",
89  "Enable Pcap for X2 link",
90  BooleanValue(false),
93  return tid;
94 }
95 
96 TypeId
98 {
99  return GetTypeId();
100 }
101 
102 void
104 {
105  NS_LOG_FUNCTION(this);
107 }
108 
109 void
111  Ptr<NetDevice> lteEnbNetDevice,
112  std::vector<uint16_t> cellIds)
113 {
114  NS_LOG_FUNCTION(this << enb << lteEnbNetDevice << cellIds.size());
115 
116  NoBackhaulEpcHelper::AddEnb(enb, lteEnbNetDevice, cellIds);
117 
118  // create a point to point link between the eNB and the SGW with
119  // the corresponding new NetDevices on each side
120  Ptr<Node> sgw = GetSgwNode();
121 
122  PointToPointHelper p2ph;
123  p2ph.SetDeviceAttribute("DataRate", DataRateValue(m_s1uLinkDataRate));
126  NetDeviceContainer enbSgwDevices = p2ph.Install(enb, sgw);
127  NS_LOG_LOGIC("Ipv4 ifaces of the eNB after installing p2p dev: "
128  << enb->GetObject<Ipv4>()->GetNInterfaces());
129 
131  {
133  }
134 
136  Ipv4InterfaceContainer enbSgwIpIfaces = m_s1uIpv4AddressHelper.Assign(enbSgwDevices);
137  NS_LOG_LOGIC("number of Ipv4 ifaces of the eNB after assigning Ipv4 addr to S1 dev: "
138  << enb->GetObject<Ipv4>()->GetNInterfaces());
139 
140  Ipv4Address enbS1uAddress = enbSgwIpIfaces.GetAddress(0);
141  Ipv4Address sgwS1uAddress = enbSgwIpIfaces.GetAddress(1);
142 
143  NoBackhaulEpcHelper::AddS1Interface(enb, enbS1uAddress, sgwS1uAddress, cellIds);
144 }
145 
146 } // namespace ns3
List of Attribute name, value and checker triples used to construct Objects.
void SetBase(Ipv4Address network, Ipv4Mask mask, Ipv4Address base="0.0.0.1")
Set the base network number, network mask and base address.
Ipv4Address NewNetwork()
Increment the network number and reset the IP address counter to the base value provided in the SetBa...
Ipv4InterfaceContainer Assign(const NetDeviceContainer &c)
Assign IP addresses to the net devices specified in the container based on the current network prefix...
Ipv4 addresses are stored in host order in this class.
Definition: ipv4-address.h:42
Access to the IPv4 forwarding table, interfaces, and configuration.
Definition: ipv4.h:80
virtual uint32_t GetNInterfaces() const =0
holds a vector of std::pair of Ptr<Ipv4> and interface index.
Ipv4Address GetAddress(uint32_t i, uint32_t j=0) const
holds a vector of ns3::NetDevice pointers
Create an EPC network with PointToPoint links between the core network nodes.
Ptr< Node > GetSgwNode() const override
Get the SGW node.
void DoDispose() override
Destructor implementation.
void AddS1Interface(Ptr< Node > enb, Ipv4Address enbAddress, Ipv4Address sgwAddress, std::vector< uint16_t > cellIds) override
Add an S1 interface between an eNB and a SGW.
void AddEnb(Ptr< Node > enbNode, Ptr< NetDevice > lteEnbNetDevice, std::vector< uint16_t > cellIds) override
Add an eNB to the EPC.
void ConstructSelf(const AttributeConstructionList &attributes)
Complete construction of ObjectBase; invoked by derived classes.
Definition: object-base.cc:85
Ptr< T > GetObject() const
Get a pointer to the requested aggregated Object.
Definition: object.h:471
void EnablePcapAll(std::string prefix, bool promiscuous=false)
Enable pcap output on each device (which is of the appropriate type) in the set of all nodes created ...
Create an EPC network with PointToPoint links in the backhaul network.
Ipv4AddressHelper m_s1uIpv4AddressHelper
S1-U interfaces.
Ipv4AddressHelper m_s1apIpv4AddressHelper
Helper to assign addresses to S1-MME NetDevices.
bool m_s1uLinkEnablePcap
Enable PCAP generation for S1 link.
DataRate m_s1uLinkDataRate
The data rate to be used for the next S1-U link to be created.
TypeId GetInstanceTypeId() const override
Get the most derived TypeId for this Object.
uint16_t m_s1uLinkMtu
The MTU of the next S1-U link to be created.
static TypeId GetTypeId()
Register this type.
void AddEnb(Ptr< Node > enbNode, Ptr< NetDevice > lteEnbNetDevice, std::vector< uint16_t > cellIds) override
Add an eNB to the EPC.
std::string m_s1uLinkPcapPrefix
Prefix for the PCAP file for the S1 link.
void DoDispose() override
Destructor implementation.
Time m_s1uLinkDelay
The delay to be used for the next S1-U link to be created.
~PointToPointEpcHelper() override
Destructor.
Build a set of PointToPointNetDevice objects.
void SetDeviceAttribute(std::string name, const AttributeValue &value)
Set an attribute value to be propagated to each NetDevice created by the helper.
void SetChannelAttribute(std::string name, const AttributeValue &value)
Set an attribute value to be propagated to each Channel created by the helper.
NetDeviceContainer Install(NodeContainer c)
Hold variables of type string.
Definition: string.h:56
a unique identifier for an interface.
Definition: type-id.h:59
TypeId SetParent(TypeId tid)
Set the parent TypeId.
Definition: type-id.cc:931
Hold an unsigned integer type.
Definition: uinteger.h:45
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Definition: log.h:202
#define NS_LOG_LOGIC(msg)
Use NS_LOG to output a message of level LOG_LOGIC.
Definition: log.h:282
#define NS_LOG_FUNCTION_NOARGS()
Output the name of the function.
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by ",...
void(* DataRate)(DataRate oldValue, DataRate newValue)
TracedValue callback signature for DataRate.
Definition: data-rate.h:327
#define NS_OBJECT_ENSURE_REGISTERED(type)
Register an Object subclass with the TypeId system.
Definition: object-base.h:46
Time Seconds(double value)
Construct a Time in the indicated unit.
Definition: nstime.h:1326
Every class exported by the ns3 library is enclosed in the ns3 namespace.
Ptr< const AttributeChecker > MakeBooleanChecker()
Definition: boolean.cc:124
Ptr< const AttributeAccessor > MakeTimeAccessor(T1 a1)
Definition: nstime.h:1414
Ptr< const AttributeChecker > MakeTimeChecker(const Time min, const Time max)
Helper to make a Time checker with bounded range.
Definition: time.cc:533
Ptr< const AttributeAccessor > MakeBooleanAccessor(T1 a1)
Definition: boolean.h:86
Ptr< const AttributeAccessor > MakeUintegerAccessor(T1 a1)
Definition: uinteger.h:46
Ptr< const AttributeChecker > MakeStringChecker()
Definition: string.cc:30
Ptr< const AttributeAccessor > MakeStringAccessor(T1 a1)
Definition: string.h:57