src/lte/model/lte-rlc-header.h
author Manuel Requena <manuel.requena@cttc.es>
Tue, 26 Mar 2013 10:41:49 +0100
changeset 10019 6efd95740e39
parent 8572 ada66b065cc2
permissions -rw-r--r--
Add automatic triger of the HO based on the RSRQ measures
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
8360
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
     1
/* -*-  Mode: C++; c-file-style: "gnu"; indent-tabs-mode:nil; -*- */
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
     2
/*
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
     3
 * Copyright (c) 2011 Centre Tecnologic de Telecomunicacions de Catalunya (CTTC)
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
     4
 *
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
     5
 * This program is free software; you can redistribute it and/or modify
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
     6
 * it under the terms of the GNU General Public License version 2 as
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
     7
 * published by the Free Software Foundation;
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
     8
 *
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
     9
 * This program is distributed in the hope that it will be useful,
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    10
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    11
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    12
 * GNU General Public License for more details.
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    13
 *
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    14
 * You should have received a copy of the GNU General Public License
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    15
 * along with this program; if not, write to the Free Software
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    16
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    17
 *
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    18
 * Author: Manuel Requena <manuel.requena@cttc.es>
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    19
 */
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    20
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    21
#ifndef LTE_RLC_HEADER_H
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    22
#define LTE_RLC_HEADER_H
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    23
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    24
#include "ns3/header.h"
8572
ada66b065cc2 Fix processing of the sequence number
Manuel Requena <manuel.requena@cttc.es>
parents: 8360
diff changeset
    25
#include "ns3/lte-rlc-sequence-number.h"
8360
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    26
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    27
#include <list>
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    28
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    29
namespace ns3 {
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    30
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    31
/**
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    32
 * \ingroup lte
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    33
 * \brief The packet header for the Radio Link Control (RLC) protocol packets
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    34
 *
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    35
 * This class has fields corresponding to those in an RLC header as well as
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    36
 * methods for serialization to and deserialization from a byte buffer.
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    37
 * It follows 3GPP TS 36.322 Radio Link Control (RLC) protocol specification.
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    38
 */
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    39
class LteRlcHeader : public Header
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    40
{
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    41
public:
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    42
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    43
  /**
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    44
   * \brief Constructor
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    45
   *
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    46
   * Creates a null header
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    47
   */
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    48
  LteRlcHeader ();
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    49
  ~LteRlcHeader ();
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    50
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    51
  void SetFramingInfo (uint8_t framingInfo);
8572
ada66b065cc2 Fix processing of the sequence number
Manuel Requena <manuel.requena@cttc.es>
parents: 8360
diff changeset
    52
  void SetSequenceNumber (SequenceNumber10 sequenceNumber);
8360
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    53
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    54
  uint8_t GetFramingInfo () const;
8572
ada66b065cc2 Fix processing of the sequence number
Manuel Requena <manuel.requena@cttc.es>
parents: 8360
diff changeset
    55
  SequenceNumber10 GetSequenceNumber () const;
8360
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    56
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    57
  void PushExtensionBit (uint8_t extensionBit);
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    58
  void PushLengthIndicator (uint16_t lengthIndicator);
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    59
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    60
  uint8_t PopExtensionBit (void);
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    61
  uint16_t PopLengthIndicator (void);
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    62
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    63
  typedef enum {
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    64
    DATA_FIELD_FOLLOWS  = 0,
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    65
    E_LI_FIELDS_FOLLOWS = 1
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    66
  } ExtensionBit_t;
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    67
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    68
  typedef enum {
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    69
    FIRST_BYTE    = 0x00,
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    70
    NO_FIRST_BYTE = 0x02
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    71
  } FramingInfoFirstByte_t;
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    72
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    73
  typedef enum {
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    74
    LAST_BYTE    = 0x00,
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    75
    NO_LAST_BYTE = 0x01
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    76
  } FramingInfoLastByte_t;
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    77
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    78
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    79
  static TypeId GetTypeId (void);
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    80
  virtual TypeId GetInstanceTypeId (void) const;
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    81
  virtual void Print (std::ostream &os) const;
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    82
  virtual uint32_t GetSerializedSize (void) const;
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    83
  virtual void Serialize (Buffer::Iterator start) const;
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    84
  virtual uint32_t Deserialize (Buffer::Iterator start);
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    85
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    86
private:
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    87
  uint16_t m_headerLength;
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    88
  uint8_t  m_framingInfo;      //  2 bits
8572
ada66b065cc2 Fix processing of the sequence number
Manuel Requena <manuel.requena@cttc.es>
parents: 8360
diff changeset
    89
  SequenceNumber10 m_sequenceNumber;
8360
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    90
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    91
  std::list <uint8_t> m_extensionBits; // Includes extensionBit of the fixed part
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    92
  std::list <uint16_t> m_lengthIndicators;
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    93
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    94
};
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    95
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    96
}; // namespace ns3
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    97
c14732f4f477 RLC header
Manuel Requena <manuel.requena@cttc.es>
parents:
diff changeset
    98
#endif // LTE_RLC_HEADER_H