epan/dissectors/packet-rlc-lte.h

   1 /* packet-rlc-lte.h
   2  *
   3  * Martin Mathieson
   4  * $Id$
   5  *
   6  * Wireshark - Network traffic analyzer
   7  * By Gerald Combs <gerald@wireshark.org>
   8  * Copyright 1998 Gerald Combs
   9  *
  10  * This program is free software; you can redistribute it and/or
  11  * modify it under the terms of the GNU General Public License
  12  * as published by the Free Software Foundation; either version 2
  13  * of the License, or (at your option) any later version.
  14  *
  15  * This program is distributed in the hope that it will be useful,
  16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18  * GNU General Public License for more details.
  19  *
  20  * You should have received a copy of the GNU General Public License
  21  * along with this program; if not, write to the Free Software
  22  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  23  */
  24
  25 /* rlcMode */
  26 #define RLC_TM_MODE 1
  27 #define RLC_UM_MODE 2
  28 #define RLC_AM_MODE 4
  29 #define RLC_PREDEF  8
  30
  31 /* direction */
  32 #define DIRECTION_UPLINK 0
  33 #define DIRECTION_DOWNLINK 1
  34
  35 /* priority ? */
  36
  37 /* channelType */
  38 #define CHANNEL_TYPE_CCCH 1
  39 #define CHANNEL_TYPE_BCCH_BCH 2
  40 #define CHANNEL_TYPE_PCCH 3
  41 #define CHANNEL_TYPE_SRB 4
  42 #define CHANNEL_TYPE_DRB 5
  43 #define CHANNEL_TYPE_BCCH_DL_SCH 6
  44 #define CHANNEL_TYPE_MCCH 7
  45 #define CHANNEL_TYPE_MTCH 8
  46
  47 /* UMSequenceNumberLength */
  48 #define UM_SN_LENGTH_5_BITS 5
  49 #define UM_SN_LENGTH_10_BITS 10
  50
  51 /* Info attached to each LTE RLC frame */
  52 typedef struct rlc_lte_info
  53 {
  54     guint8          rlcMode;
  55     guint8          direction;
  56     guint8          priority;
  57     guint16         ueid;
  58     guint16         channelType;
  59     guint16         channelId;
  60     guint16         pduLength;
  61     guint8          UMSequenceNumberLength;
  62 } rlc_lte_info;
  63
  64
  65 typedef struct rlc_lte_tap_info {
  66     /* Info from context */
  67     guint8          rlcMode;
  68     guint8          direction;
  69     guint8          priority;
  70     guint16         ueid;
  71     guint16         channelType;
  72     guint16         channelId;
  73     guint16         pduLength;
  74     guint8          UMSequenceNumberLength;
  75
  76     nstime_t        time;
  77     guint8          loggedInMACFrame;
  78     guint16         sequenceNumber;
  79     guint8          isResegmented;
  80     guint8          isControlPDU;
  81     guint16         ACKNo;
  82     #define MAX_NACKs 128
  83     guint16         noOfNACKs;
  84     guint16         NACKs[MAX_NACKs];
  85
  86     guint16         missingSNs;
  87 } rlc_lte_tap_info;
  88
  89
  90 /* Configure number of PDCP SN bits to use for DRB channels. */
  91 void set_rlc_lte_drb_pdcp_seqnum_length(guint16 ueid, guint8 drbid, guint8 userplane_seqnum_length);
  92
  93
  94 /*****************************************************************/
  95 /* UDP framing format                                            */
  96 /* -----------------------                                       */
  97 /* Several people have asked about dissecting RLC by framing     */
  98 /* PDUs over IP.  A suggested format over UDP has been defined   */
  99 /* and implemented by this dissector, using the definitions      */
 100 /* below. A link to an example program showing you how to encode */
 101 /* these headers and send LTE RLC PDUs on a UDP socket is        */
 102 /* provided at http://wiki.wireshark.org/RLC-LTE                 */
 103 /*                                                               */
 104 /* A heuristic dissecter (enabled by a preference) will          */
 105 /* recognise a signature at the beginning of these frames.       */
 106 /* Until someone is using this format, suggestions for changes   */
 107 /* are welcome.                                                  */
 108 /*****************************************************************/
 109
 110
 111 /* Signature.  Rather than try to define a port for this, or make the
 112    port number a preference, frames will start with this string (with no
 113    terminating NULL */
 114 #define RLC_LTE_START_STRING "rlc-lte"
 115
 116 /* Fixed field.  This is followed by the following 1 mandatory field:
 117    - rlcMode (1 byte)
 118    (where the allowed values are defined above */
 119
 120 /* Conditional field. This field is mandatory in case of RLC Unacknowledged mode.
 121    The format is to have the tag, followed by the value (there is no length field,
 122    it's implicit from the tag). The allowed values are defined above. */
 123
 124 #define RLC_LTE_UM_SN_LENGTH_TAG    0x02
 125 /* 1 byte */
 126
 127 /* Optional fields. Attaching this info to frames will allow you
 128    to show you display/filter/plot/add-custom-columns on these fields, so should
 129    be added if available.
 130    The format is to have the tag, followed by the value (there is no length field,
 131    it's implicit from the tag) */
 132
 133 #define RLC_LTE_DIRECTION_TAG       0x03
 134 /* 1 byte */
 135
 136 #define RLC_LTE_PRIORITY_TAG        0x04
 137 /* 1 byte */
 138
 139 #define RLC_LTE_UEID_TAG            0x05
 140 /* 2 bytes, network order */
 141
 142 #define RLC_LTE_CHANNEL_TYPE_TAG    0x06
 143 /* 2 bytes, network order */
 144
 145 #define RLC_LTE_CHANNEL_ID_TAG      0x07
 146 /* 2 bytes, network order */
 147
 148
 149 /* RLC PDU. Following this tag comes the actual RLC PDU (there is no length, the PDU
 150    continues until the end of the frame) */
 151 #define RLC_LTE_PAYLOAD_TAG         0x01
 152
 153