A Discrete-Event Network Simulator
API
lte-rlc-am.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2011 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  * Author: Manuel Requena <manuel.requena@cttc.es>
18  */
19 
20 #ifndef LTE_RLC_AM_H
21 #define LTE_RLC_AM_H
22 
23 #include <ns3/event-id.h>
24 #include <ns3/lte-rlc-sequence-number.h>
25 #include <ns3/lte-rlc.h>
26 
27 #include <map>
28 #include <vector>
29 
30 namespace ns3
31 {
32 
36 class LteRlcAm : public LteRlc
37 {
38  public:
39  LteRlcAm();
40  ~LteRlcAm() override;
45  static TypeId GetTypeId();
46  void DoDispose() override;
47 
53  void DoTransmitPdcpPdu(Ptr<Packet> p) override;
54 
64  void DoNotifyHarqDeliveryFailure() override;
65  void DoReceivePdu(LteMacSapUser::ReceivePduParameters rxPduParams) override;
66 
67  private:
73  void ExpireReorderingTimer();
77  void ExpireRbsTimer();
78 
84 
92  //
93  // void ReassembleOutsideWindow ();
94  // void ReassembleSnLessThan (uint16_t seqNumber);
95  //
96 
102  void ReassembleAndDeliver(Ptr<Packet> packet);
103 
107  void DoReportBufferStatus();
108 
109  private:
113  struct TxPdu
114  {
120  TxPdu(const Ptr<Packet>& pdu, const Time& time)
121  : m_pdu(pdu),
122  m_waitingSince(time)
123  {
124  }
125 
126  TxPdu() = delete;
127 
130  };
131 
132  std::vector<TxPdu> m_txonBuffer;
133 
135  struct RetxPdu
136  {
138  uint16_t m_retxCount;
140  };
141 
142  std::vector<RetxPdu> m_txedBuffer;
145  std::vector<RetxPdu> m_retxBuffer;
146 
147  uint32_t m_maxTxBufferSize;
148  uint32_t m_txonBufferSize;
149  uint32_t m_retxBufferSize;
150  uint32_t m_txedBufferSize;
151 
154 
156  struct PduBuffer
157  {
159  std::list<Ptr<Packet>> m_byteSegments;
160 
162  };
163 
164  std::map<uint16_t, PduBuffer> m_rxonBuffer;
165 
167 
168  // SDU reassembly
169  // std::vector < Ptr<Packet> > m_reasBuffer; // Reassembling buffer
170  //
171  std::list<Ptr<Packet>> m_sdusBuffer;
172 
176  // Transmitting side
181 
182  // Receiving side
188 
192  uint32_t m_pduWithoutPoll;
193  uint32_t m_byteWithoutPoll;
194 
198  uint16_t m_windowSize;
199 
211 
216  uint16_t m_pollPdu;
217  uint16_t m_pollByte;
218 
221 
226  {
227  NONE = 0,
229  WAITING_SI_SF = 2
230  };
231 
234 
239 };
240 
241 } // namespace ns3
242 
243 #endif // LTE_RLC_AM_H
An identifier for simulation events.
Definition: event-id.h:55
LTE RLC Acknowledged Mode (AM), see 3GPP TS 36.322.
Definition: lte-rlc-am.h:37
ReassemblingState_t m_reassemblingState
reassembling state
Definition: lte-rlc-am.h:232
void ExpireStatusProhibitTimer()
method called when the T_status_prohibit timer expires
Definition: lte-rlc-am.cc:1774
SequenceNumber10 m_vrMr
VR(MR)
Definition: lte-rlc-am.h:184
Time m_statusProhibitTimerValue
status prohibit timer value
Definition: lte-rlc-am.h:208
bool IsInsideReceivingWindow(SequenceNumber10 seqNumber)
method called when the T_status_prohibit timer expires
Definition: lte-rlc-am.cc:1162
uint16_t m_windowSize
Constants.
Definition: lte-rlc-am.h:198
Ptr< Packet > m_keepS0
keep S0
Definition: lte-rlc-am.h:233
void DoNotifyHarqDeliveryFailure() override
Notify HARQ delivery failure.
Definition: lte-rlc-am.cc:782
SequenceNumber10 m_vrH
VR(H)
Definition: lte-rlc-am.h:187
uint32_t m_txonBufferSize
transmit on buffer size
Definition: lte-rlc-am.h:148
ReassemblingState_t
SDU Reassembling state.
Definition: lte-rlc-am.h:226
std::vector< TxPdu > m_txonBuffer
Transmission buffer.
Definition: lte-rlc-am.h:132
SequenceNumber10 m_vrMs
VR(MS)
Definition: lte-rlc-am.h:186
uint16_t m_pollByte
poll byte
Definition: lte-rlc-am.h:217
SequenceNumber10 m_vtS
VT(S)
Definition: lte-rlc-am.h:179
void DoDispose() override
Destructor implementation.
Definition: lte-rlc-am.cc:132
SequenceNumber10 m_pollSn
POLL_SN.
Definition: lte-rlc-am.h:180
SequenceNumber10 m_vtA
State variables.
Definition: lte-rlc-am.h:177
void ExpireReorderingTimer()
This method will schedule a timeout at WaitReplyTimeout interval in the future, unless a timer is alr...
Definition: lte-rlc-am.cc:1688
SequenceNumber10 m_vtMs
VT(MS)
Definition: lte-rlc-am.h:178
EventId m_rbsTimer
RBS timer.
Definition: lte-rlc-am.h:209
~LteRlcAm() override
Definition: lte-rlc-am.cc:80
uint32_t m_statusPduBufferSize
status PDU buffer size
Definition: lte-rlc-am.h:153
Ptr< Packet > m_controlPduBuffer
Control PDU buffer (just one PDU)
Definition: lte-rlc-am.h:166
bool m_txOpportunityForRetxAlwaysBigEnough
transmit opportunity for retransmit?
Definition: lte-rlc-am.h:219
bool m_pollRetransmitTimerJustExpired
poll retransmit timer just expired?
Definition: lte-rlc-am.h:220
void DoTransmitPdcpPdu(Ptr< Packet > p) override
RLC SAP.
Definition: lte-rlc-am.cc:160
Time m_reorderingTimerValue
reordering timer value
Definition: lte-rlc-am.h:206
uint32_t m_maxTxBufferSize
maximum transmission buffer size
Definition: lte-rlc-am.h:147
void DoReceivePdu(LteMacSapUser::ReceivePduParameters rxPduParams) override
Receive PDU function.
Definition: lte-rlc-am.cc:788
std::list< Ptr< Packet > > m_sdusBuffer
List of SDUs in a packet (PDU)
Definition: lte-rlc-am.h:171
EventId m_pollRetransmitTimer
Timers.
Definition: lte-rlc-am.h:203
uint16_t m_maxRetxThreshold
Configurable parameters.
Definition: lte-rlc-am.h:215
SequenceNumber10 m_vrX
VR(X)
Definition: lte-rlc-am.h:185
std::vector< RetxPdu > m_retxBuffer
Buffer for PDUs considered for retransmission.
Definition: lte-rlc-am.h:145
uint32_t m_byteWithoutPoll
byte without poll
Definition: lte-rlc-am.h:193
void ExpireRbsTimer()
Expire RBS timer.
Definition: lte-rlc-am.cc:1780
uint32_t m_pduWithoutPoll
Counters.
Definition: lte-rlc-am.h:192
static TypeId GetTypeId()
Get the type ID.
Definition: lte-rlc-am.cc:86
void DoNotifyTxOpportunity(LteMacSapUser::TxOpportunityParameters txOpParams) override
MAC SAP.
Definition: lte-rlc-am.cc:198
Time m_pollRetransmitTimerValue
poll retransmit time value
Definition: lte-rlc-am.h:204
void DoReportBufferStatus()
Report buffer status.
Definition: lte-rlc-am.cc:1618
void ReassembleAndDeliver(Ptr< Packet > packet)
Reassemble and deliver.
Definition: lte-rlc-am.cc:1184
std::map< uint16_t, PduBuffer > m_rxonBuffer
Reception buffer.
Definition: lte-rlc-am.h:164
uint32_t m_txedBufferSize
transmit ed buffer size
Definition: lte-rlc-am.h:150
uint16_t m_pollPdu
poll PDU
Definition: lte-rlc-am.h:216
EventId m_reorderingTimer
reordering timer
Definition: lte-rlc-am.h:205
void ExpirePollRetransmitTimer()
Expire poll retransmitter.
Definition: lte-rlc-am.cc:1730
SequenceNumber10 m_vrR
VR(R)
Definition: lte-rlc-am.h:183
SequenceNumber10 m_expectedSeqNumber
Expected Sequence Number.
Definition: lte-rlc-am.h:238
uint32_t m_retxBufferSize
retransmit buffer size
Definition: lte-rlc-am.h:149
EventId m_statusProhibitTimer
status prohibit timer
Definition: lte-rlc-am.h:207
std::vector< RetxPdu > m_txedBuffer
Buffer for transmitted and retransmitted PDUs that have not been acked but are not considered for ret...
Definition: lte-rlc-am.h:142
bool m_statusPduRequested
status PDU requested
Definition: lte-rlc-am.h:152
Time m_rbsTimerValue
RBS timer value.
Definition: lte-rlc-am.h:210
This abstract base class defines the API to interact with the Radio Link Control (LTE_RLC) in LTE,...
Definition: lte-rlc.h:48
SequenceNumber10 class.
Simulation virtual time values and global simulation resolution.
Definition: nstime.h:105
a unique identifier for an interface.
Definition: type-id.h:60
Every class exported by the ns3 library is enclosed in the ns3 namespace.
Parameters for LteMacSapUser::ReceivePdu.
Definition: lte-mac-sap.h:166
Parameters for LteMacSapUser::NotifyTxOpportunity.
Definition: lte-mac-sap.h:105
PduBuffer structure.
Definition: lte-rlc-am.h:157
SequenceNumber10 m_seqNumber
sequence number
Definition: lte-rlc-am.h:158
bool m_pduComplete
PDU complete?
Definition: lte-rlc-am.h:161
std::list< Ptr< Packet > > m_byteSegments
byte segments
Definition: lte-rlc-am.h:159
RetxPdu structure.
Definition: lte-rlc-am.h:136
uint16_t m_retxCount
retransmit count
Definition: lte-rlc-am.h:138
Ptr< Packet > m_pdu
PDU.
Definition: lte-rlc-am.h:137
Time m_waitingSince
Layer arrival time.
Definition: lte-rlc-am.h:139
Store an incoming (from layer above us) PDU, waiting to transmit it.
Definition: lte-rlc-am.h:114
TxPdu(const Ptr< Packet > &pdu, const Time &time)
TxPdu default constructor.
Definition: lte-rlc-am.h:120
Time m_waitingSince
Layer arrival time.
Definition: lte-rlc-am.h:129
Ptr< Packet > m_pdu
PDU.
Definition: lte-rlc-am.h:128