A Discrete-Event Network Simulator
API
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
epc-sgw-pgw-application.cc
Go to the documentation of this file.
1 /* -*- Mode: C++; c-file-style: "gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2011 Centre Tecnologic de Telecomunicacions de Catalunya (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: Jaume Nin <jnin@cttc.cat>
19  * Nicola Baldo <nbaldo@cttc.cat>
20  */
21 
22 
24 #include "ns3/log.h"
25 #include "ns3/mac48-address.h"
26 #include "ns3/ipv4.h"
27 #include "ns3/inet-socket-address.h"
28 #include "ns3/epc-gtpu-header.h"
29 #include "ns3/abort.h"
30 
31 namespace ns3 {
32 
33 NS_LOG_COMPONENT_DEFINE ("EpcSgwPgwApplication");
34 
35 
37 // UeInfo
39 
40 
42 {
43  NS_LOG_FUNCTION (this);
44 }
45 
46 void
47 EpcSgwPgwApplication::UeInfo::AddBearer (Ptr<EpcTft> tft, uint8_t bearerId, uint32_t teid)
48 {
49  NS_LOG_FUNCTION (this << tft << teid);
50  m_teidByBearerIdMap[bearerId] = teid;
51  return m_tftClassifier.Add (tft, teid);
52 }
53 
54 uint32_t
56 {
57  NS_LOG_FUNCTION (this << p);
58  // we hardcode DOWNLINK direction since the PGW is espected to
59  // classify only downlink packets (uplink packets will go to the
60  // internet without any classification).
61  return m_tftClassifier.Classify (p, EpcTft::DOWNLINK);
62 }
63 
66 {
67  return m_enbAddr;
68 }
69 
70 void
72 {
73  m_enbAddr = enbAddr;
74 }
75 
78 {
79  return m_ueAddr;
80 }
81 
82 void
84 {
85  m_ueAddr = ueAddr;
86 }
87 
89 // EpcSgwPgwApplication
91 
92 
93 TypeId
95 {
96  static TypeId tid = TypeId ("ns3::EpcSgwPgwApplication")
97  .SetParent<Object> ();
98  return tid;
99 }
100 
101 void
103 {
104  NS_LOG_FUNCTION (this);
106  m_s1uSocket = 0;
107  delete (m_s11SapSgw);
108 }
109 
110 
111 
113  : m_s1uSocket (s1uSocket),
114  m_tunDevice (tunDevice),
115  m_gtpuUdpPort (2152), // fixed by the standard
116  m_teidCount (0),
117  m_s11SapMme (0)
118 {
119  NS_LOG_FUNCTION (this << tunDevice << s1uSocket);
122 }
123 
124 
126 {
127  NS_LOG_FUNCTION (this);
128 }
129 
130 
131 bool
132 EpcSgwPgwApplication::RecvFromTunDevice (Ptr<Packet> packet, const Address& source, const Address& dest, uint16_t protocolNumber)
133 {
134  NS_LOG_FUNCTION (this << source << dest << packet << packet->GetSize ());
135 
136  // get IP address of UE
137  Ptr<Packet> pCopy = packet->Copy ();
138  Ipv4Header ipv4Header;
139  pCopy->RemoveHeader (ipv4Header);
140  Ipv4Address ueAddr = ipv4Header.GetDestination ();
141  NS_LOG_LOGIC ("packet addressed to UE " << ueAddr);
142 
143  // find corresponding UeInfo address
144  std::map<Ipv4Address, Ptr<UeInfo> >::iterator it = m_ueInfoByAddrMap.find (ueAddr);
145  if (it == m_ueInfoByAddrMap.end ())
146  {
147  NS_LOG_WARN ("unknown UE address " << ueAddr) ;
148  }
149  else
150  {
151  Ipv4Address enbAddr = it->second->GetEnbAddr ();
152  uint32_t teid = it->second->Classify (packet);
153  if (teid == 0)
154  {
155  NS_LOG_WARN ("no matching bearer for this packet");
156  }
157  else
158  {
159  SendToS1uSocket (packet, enbAddr, teid);
160  }
161  }
162  // there is no reason why we should notify the TUN
163  // VirtualNetDevice that he failed to send the packet: if we receive
164  // any bogus packet, it will just be silently discarded.
165  const bool succeeded = true;
166  return succeeded;
167 }
168 
169 void
171 {
172  NS_LOG_FUNCTION (this << socket);
173  NS_ASSERT (socket == m_s1uSocket);
174  Ptr<Packet> packet = socket->Recv ();
175  GtpuHeader gtpu;
176  packet->RemoveHeader (gtpu);
177  uint32_t teid = gtpu.GetTeid ();
178 
181  SocketAddressTag tag;
182  packet->RemovePacketTag (tag);
183 
184  SendToTunDevice (packet, teid);
185 }
186 
187 void
189 {
190  NS_LOG_FUNCTION (this << packet << teid);
191  NS_LOG_LOGIC (" packet size: " << packet->GetSize () << " bytes");
193 }
194 
195 void
197 {
198  NS_LOG_FUNCTION (this << packet << enbAddr << teid);
199 
200  GtpuHeader gtpu;
201  gtpu.SetTeid (teid);
202  // From 3GPP TS 29.281 v10.0.0 Section 5.1
203  // Length of the payload + the non obligatory GTP-U header
204  gtpu.SetLength (packet->GetSize () + gtpu.GetSerializedSize () - 8);
205  packet->AddHeader (gtpu);
206  uint32_t flags = 0;
207  m_s1uSocket->SendTo (packet, flags, InetSocketAddress(enbAddr, m_gtpuUdpPort));
208 }
209 
210 
211 void
213 {
214  m_s11SapMme = s;
215 }
216 
217 EpcS11SapSgw*
219 {
220  return m_s11SapSgw;
221 }
222 
223 void
224 EpcSgwPgwApplication::AddEnb (uint16_t cellId, Ipv4Address enbAddr, Ipv4Address sgwAddr)
225 {
226  NS_LOG_FUNCTION (this << cellId << enbAddr << sgwAddr);
227  EnbInfo enbInfo;
228  enbInfo.enbAddr = enbAddr;
229  enbInfo.sgwAddr = sgwAddr;
230  m_enbInfoByCellId[cellId] = enbInfo;
231 }
232 
233 void
235 {
236  NS_LOG_FUNCTION (this << imsi);
237  Ptr<UeInfo> ueInfo = Create<UeInfo> ();
238  m_ueInfoByImsiMap[imsi] = ueInfo;
239 }
240 
241 void
243 {
244  NS_LOG_FUNCTION (this << imsi << ueAddr);
245  std::map<uint64_t, Ptr<UeInfo> >::iterator ueit = m_ueInfoByImsiMap.find (imsi);
246  NS_ASSERT_MSG (ueit != m_ueInfoByImsiMap.end (), "unknown IMSI " << imsi);
247  m_ueInfoByAddrMap[ueAddr] = ueit->second;
248  ueit->second->SetUeAddr (ueAddr);
249 }
250 
251 void
253 {
254  NS_LOG_FUNCTION (this << req.imsi);
255  std::map<uint64_t, Ptr<UeInfo> >::iterator ueit = m_ueInfoByImsiMap.find (req.imsi);
256  NS_ASSERT_MSG (ueit != m_ueInfoByImsiMap.end (), "unknown IMSI " << req.imsi);
257  uint16_t cellId = req.uli.gci;
258  std::map<uint16_t, EnbInfo>::iterator enbit = m_enbInfoByCellId.find (cellId);
259  NS_ASSERT_MSG (enbit != m_enbInfoByCellId.end (), "unknown CellId " << cellId);
260  Ipv4Address enbAddr = enbit->second.enbAddr;
261  ueit->second->SetEnbAddr (enbAddr);
262 
264  res.teid = req.imsi; // trick to avoid the need for allocating TEIDs on the S11 interface
265 
266  for (std::list<EpcS11SapSgw::BearerContextToBeCreated>::iterator bit = req.bearerContextsToBeCreated.begin ();
267  bit != req.bearerContextsToBeCreated.end ();
268  ++bit)
269  {
270  // simple sanity check. If you ever need more than 4M teids
271  // throughout your simulation, you'll need to implement a smarter teid
272  // management algorithm.
273  NS_ABORT_IF (m_teidCount == 0xFFFFFFFF);
274  uint32_t teid = ++m_teidCount;
275  ueit->second->AddBearer (bit->tft, bit->epsBearerId, teid);
276 
278  bearerContext.sgwFteid.teid = teid;
279  bearerContext.sgwFteid.address = enbit->second.sgwAddr;
280  bearerContext.epsBearerId = bit->epsBearerId;
281  bearerContext.bearerLevelQos = bit->bearerLevelQos;
282  bearerContext.tft = bit->tft;
283  res.bearerContextsCreated.push_back (bearerContext);
284  }
286 
287 }
288 
289 void
291 {
292  NS_LOG_FUNCTION (this << req.teid);
293  uint64_t imsi = req.teid; // trick to avoid the need for allocating TEIDs on the S11 interface
294  std::map<uint64_t, Ptr<UeInfo> >::iterator ueit = m_ueInfoByImsiMap.find (imsi);
295  NS_ASSERT_MSG (ueit != m_ueInfoByImsiMap.end (), "unknown IMSI " << imsi);
296  uint16_t cellId = req.uli.gci;
297  std::map<uint16_t, EnbInfo>::iterator enbit = m_enbInfoByCellId.find (cellId);
298  NS_ASSERT_MSG (enbit != m_enbInfoByCellId.end (), "unknown CellId " << cellId);
299  Ipv4Address enbAddr = enbit->second.enbAddr;
300  ueit->second->SetEnbAddr (enbAddr);
301  // no actual bearer modification: for now we just support the minimum needed for path switch request (handover)
303  res.teid = imsi; // trick to avoid the need for allocating TEIDs on the S11 interface
306 }
307 
308 }; // namespace ns3
uint32_t RemoveHeader(Header &header)
Deserialize and remove the header from the internal buffer.
Definition: packet.cc:268
std::map< uint16_t, EnbInfo > m_enbInfoByCellId
enum ns3::EpcS11SapMme::ModifyBearerResponseMessage::Cause cause
an Inet address class
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 "...
3GPP TS 29.274 version 8.3.1 Release 8 section 8.28
Definition: epc-s11-sap.h:80
Ipv4Address address
Definition: epc-s11-sap.h:51
MME side of the S11 Service Access Point (SAP), provides the MME methods to be called when an S11 mes...
Definition: epc-s11-sap.h:72
uint16_t m_gtpuUdpPort
UDP port to be used for GTP.
void SetS11SapMme(EpcS11SapMme *s)
Set the MME side of the S11 SAP.
Ipv4Address GetDestination(void) const
Definition: ipv4-header.cc:304
EpcS11SapMme * m_s11SapMme
MME side of the S11 SAP.
#define NS_ASSERT(condition)
At runtime, in debugging builds, if this condition is not true, the program prints the source file...
Definition: assert.h:61
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Definition: log.h:170
uint32_t GetSize(void) const
Returns the the size in bytes of the packet (including the zero-filled initial payload).
Definition: packet.h:744
bool Receive(Ptr< Packet > packet, uint16_t protocol, const Address &source, const Address &destination, PacketType packetType)
Callback< R > MakeNullCallback(void)
Definition: callback.h:1399
void SendToTunDevice(Ptr< Packet > packet, uint32_t teid)
Send a packet to the internet via the Gi interface of the SGW/PGW.
a polymophic address class
Definition: address.h:86
Template for the implementation of the EpcS11SapSgw as a member of an owner class of type C to which ...
Definition: epc-s11-sap.h:242
Packet header for IPv4.
Definition: ipv4-header.h:31
virtual Address GetAddress(void) const
virtual uint32_t GetSerializedSize(void) const
bool RecvFromTunDevice(Ptr< Packet > packet, const Address &source, const Address &dest, uint16_t protocolNumber)
Method to be assigned to the callback of the Gi TUN VirtualNetDevice.
Ptr< SampleEmitter > s
Ptr< VirtualNetDevice > m_tunDevice
TUN VirtualNetDevice used for tunneling/detunneling IP packets from/to the internet over GTP-U/UDP/IP...
std::map< uint64_t, Ptr< UeInfo > > m_ueInfoByImsiMap
Map telling for each IMSI the corresponding UE info.
void DoCreateSessionRequest(EpcS11SapSgw::CreateSessionRequestMessage msg)
void SetUeAddr(Ipv4Address addr)
set the address of the UE
virtual void ModifyBearerResponse(ModifyBearerResponseMessage msg)=0
send a Modify Bearer Response message
This class implements a tag that carries an address of a packet across the socket interface...
Definition: socket.h:948
Callback< R > MakeCallback(R(T::*memPtr)(void), OBJ objPtr)
Definition: callback.h:1242
void SetRecvCallback(Callback< void, Ptr< Socket > >)
Notify application when new data is available to be read.
Definition: socket.cc:127
#define NS_LOG_LOGIC(msg)
Use NS_LOG to output a message of level LOG_LOGIC.
Definition: log.h:233
Modify Bearer Request message, see 3GPP TS 29.274 7.2.7.
Definition: epc-s11-sap.h:169
Ptr< Packet > Copy(void) const
performs a COW copy of the packet.
Definition: packet.cc:122
void SetTeid(uint32_t m_teid)
void AddBearer(Ptr< EpcTft > tft, uint8_t epsBearerId, uint32_t teid)
virtual Ptr< Packet > Recv(uint32_t maxSize, uint32_t flags)=0
Read data from the socket.
std::list< BearerContextCreated > bearerContextsCreated
Definition: epc-s11-sap.h:95
void SetUeAddress(uint64_t imsi, Ipv4Address ueAddr)
set the address of a previously added UE
uint32_t GetTeid() const
void AddUe(uint64_t imsi)
Let the SGW be aware of a new UE.
void SendToS1uSocket(Ptr< Packet > packet, Ipv4Address enbS1uAddress, uint32_t teid)
Send a packet to the SGW via the S1-U interface.
#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
Ptr< Socket > m_s1uSocket
UDP socket to send and receive GTP-U packets to and from the S1-U interface.
#define NS_ABORT_IF(cond)
Abnormal program termination if cond is true.
Definition: abort.h:71
std::map< Ipv4Address, Ptr< UeInfo > > m_ueInfoByAddrMap
Map telling for each UE address the corresponding UE info.
Ipv4 addresses are stored in host order in this class.
Definition: ipv4-address.h:38
SGW side of the S11 Service Access Point (SAP), provides the SGW methods to be called when an S11 mes...
Definition: epc-s11-sap.h:135
std::list< BearerContextToBeCreated > bearerContextsToBeCreated
Definition: epc-s11-sap.h:155
virtual void CreateSessionResponse(CreateSessionResponseMessage msg)=0
send a Create Session Response message
void SetEnbAddr(Ipv4Address addr)
set the address of the eNB to which the UE is connected
Packet addressed oo us.
Definition: net-device.h:276
#define NS_LOG_WARN(msg)
Use NS_LOG to output a message of level LOG_WARN.
Definition: log.h:203
bool RemovePacketTag(Tag &tag)
Remove a packet tag.
Definition: packet.cc:848
virtual void DoDispose()
This method is called by Object::Dispose or by the object's destructor, whichever comes first...
void SetLength(uint16_t m_length)
void RecvFromS1uSocket(Ptr< Socket > socket)
Method to be assigned to the recv callback of the S1-U socket.
virtual ~EpcSgwPgwApplication(void)
Destructor.
virtual int SendTo(Ptr< Packet > p, uint32_t flags, const Address &toAddress)=0
Send data to a specified peer.
a base class which provides memory management and object aggregation
Definition: object.h:64
Modify Bearer Response message, see 3GPP TS 29.274 7.2.7.
Definition: epc-s11-sap.h:110
void DoModifyBearerRequest(EpcS11SapSgw::ModifyBearerRequestMessage msg)
EpcS11SapSgw * m_s11SapSgw
SGW side of the S11 SAP.
a unique identifier for an interface.
Definition: type-id.h:49
TypeId SetParent(TypeId tid)
Definition: type-id.cc:610
void AddEnb(uint16_t cellId, Ipv4Address enbAddr, Ipv4Address sgwAddr)
Let the SGW be aware of a new eNB.
void AddHeader(const Header &header)
Add header to this packet.
Definition: packet.cc:253
Create Session Request message, see 3GPP TS 29.274 7.2.1.
Definition: epc-s11-sap.h:151
EpcSgwPgwApplication(const Ptr< VirtualNetDevice > tunDevice, const Ptr< Socket > s1uSocket)
Constructor that binds the tap device to the callback methods.
Implementation of the GTPv1-U Release 10 as per 3Gpp TS 29.281 document.
Create Session Response message, see 3GPP TS 29.274 7.2.2.
Definition: epc-s11-sap.h:93