plugins/epan/profinet/packet-pn-mrrt.c

   1 /* packet-pn-mrrt.c
   2  * Routines for PN-MRRT (PROFINET Media Redundancy for cyclic realtime data)
   3  * packet dissection.
   4  *
   5  * Wireshark - Network traffic analyzer
   6  * By Gerald Combs <gerald@wireshark.org>
   7  * Copyright 1998 Gerald Combs
   8  *
   9  * SPDX-License-Identifier: GPL-2.0-or-later
  10  */
  11
  12 #include "config.h"
  13
  14 #include <epan/packet.h>
  15 #include <epan/dissectors/packet-dcerpc.h>
  16
  17 #include "packet-pn.h"
  18
  19 void proto_register_pn_mrrt(void);
  20 void proto_reg_handoff_pn_mrrt(void);
  21
  22 static int proto_pn_mrrt;
  23
  24 static int hf_pn_mrrt_sequence_id;
  25 static int hf_pn_mrrt_domain_uuid;
  26 static int hf_pn_mrrt_type;
  27 static int hf_pn_mrrt_length;
  28 static int hf_pn_mrrt_version;
  29 static int hf_pn_mrrt_sa;
  30
  31
  32 static int ett_pn_mrrt;
  33
  34
  35
  36 static const value_string pn_mrrt_block_type_vals[] = {
  37     { 0x00, "End" },
  38     { 0x01, "Common" },
  39     { 0x02, "Test" },
  40     /*0x03 - 0x7E Reserved */
  41     { 0x7F, "Organizationally Specific"},
  42     { 0, NULL },
  43 };
  44
  45
  46
  47
  48 static int
  49 dissect_PNMRRT_Common(tvbuff_t *tvb, int offset,
  50         packet_info *pinfo, proto_tree *tree, proto_item *item, uint8_t length _U_)
  51 {
  52     uint16_t sequence_id;
  53     e_guid_t uuid;
  54
  55
  56     /* MRRT_SequenceID */
  57     offset = dissect_pn_uint16(tvb, offset, pinfo, tree, hf_pn_mrrt_sequence_id, &sequence_id);
  58
  59     /* MRRT_DomainUUID */
  60     offset = dissect_pn_uuid(tvb, offset, pinfo, tree, hf_pn_mrrt_domain_uuid, &uuid);
  61
  62     col_append_str(pinfo->cinfo, COL_INFO, "Common");
  63
  64     proto_item_append_text(item, "Common");
  65
  66     return offset;
  67 }
  68
  69
  70 static int
  71 dissect_PNMRRT_Test(tvbuff_t *tvb, int offset,
  72         packet_info *pinfo, proto_tree *tree, proto_item *item, uint8_t length _U_)
  73 {
  74     uint8_t mac[6];
  75
  76
  77     /* MRRT_SA */
  78     offset = dissect_pn_mac(tvb, offset, pinfo, tree, hf_pn_mrrt_sa, mac);
  79
  80     /* Padding */
  81     offset = dissect_pn_align4(tvb, offset, pinfo, tree);
  82
  83     col_append_str(pinfo->cinfo, COL_INFO, "Test");
  84
  85     proto_item_append_text(item, "Test");
  86
  87     return offset;
  88 }
  89
  90 static int
  91 dissect_PNMRRT_PDU(tvbuff_t *tvb, int offset,
  92         packet_info *pinfo, proto_tree *tree, proto_item *item)
  93 {
  94     uint16_t version;
  95     uint8_t type;
  96     uint8_t length;
  97     int     i = 0;
  98
  99
 100     /* MRRT_Version */
 101     offset = dissect_pn_uint16(tvb, offset, pinfo, tree, hf_pn_mrrt_version, &version);
 102
 103     while (tvb_reported_length_remaining(tvb, offset) > 0) {
 104         /* MRRT_TLVHeader.Type */
 105         offset = dissect_pn_uint8(tvb, offset, pinfo, tree, hf_pn_mrrt_type, &type);
 106
 107         /* MRRT_TLVHeader.Length */
 108         offset = dissect_pn_uint8(tvb, offset, pinfo, tree, hf_pn_mrrt_length, &length);
 109
 110
 111         if (i != 0) {
 112             col_append_str(pinfo->cinfo, COL_INFO, ", ");
 113
 114             proto_item_append_text(item, ", ");
 115         }
 116
 117         i++;
 118
 119         switch(type) {
 120         case 0x00:
 121             /* no content */
 122             col_append_str(pinfo->cinfo, COL_INFO, "End");
 123             proto_item_append_text(item, "End");
 124             return offset;
 125         case 0x01:
 126             offset = dissect_PNMRRT_Common(tvb, offset, pinfo, tree, item, length);
 127             break;
 128         case 0x02:
 129             offset = dissect_PNMRRT_Test(tvb, offset, pinfo, tree, item, length);
 130             break;
 131         default:
 132             offset = dissect_pn_undecoded(tvb, offset, pinfo, tree, length);
 133
 134             col_append_fstr(pinfo->cinfo, COL_INFO, "Unknown TLVType 0x%x", type);
 135             proto_item_append_text(item, "Unknown TLVType 0x%x", type);
 136             break;
 137         }
 138     }
 139
 140     return offset;
 141 }
 142
 143
 144 /* possibly dissect a PN-RT packet (frame ID must be in the appropriate range) */
 145 static bool
 146 dissect_PNMRRT_Data_heur(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree,
 147     void *data)
 148 {
 149     /* the tvb will NOT contain the frame_id here, so get it from dissector data! */
 150     uint16_t    u16FrameID = GPOINTER_TO_UINT(data);
 151     proto_item *item;
 152     proto_tree *mrrt_tree;
 153     int         offset    = 0;
 154     uint32_t    u32SubStart;
 155
 156
 157     /* frame id must be in valid range (MRRT) */
 158     if (u16FrameID != 0xFF60) {
 159         /* we are not interested in this packet */
 160         return false;
 161     }
 162
 163     col_set_str(pinfo->cinfo, COL_PROTOCOL, "PN-MRRT");
 164     col_clear(pinfo->cinfo, COL_INFO);
 165
 166     /* subtree for MRRT */
 167     item        = proto_tree_add_protocol_format(tree, proto_pn_mrrt, tvb, 0, 0, "PROFINET MRRT, ");
 168     mrrt_tree   = proto_item_add_subtree(item, ett_pn_mrrt);
 169     u32SubStart = offset;
 170
 171     offset = dissect_PNMRRT_PDU(tvb, offset, pinfo, mrrt_tree, item);
 172
 173     proto_item_set_len(item, offset - u32SubStart);
 174
 175     return true;
 176 }
 177
 178
 179 void
 180 proto_register_pn_mrrt (void)
 181 {
 182     static hf_register_info hf[] = {
 183
 184         { &hf_pn_mrrt_type,
 185           { "Type", "pn_mrrt.type",
 186             FT_UINT8, BASE_HEX, VALS(pn_mrrt_block_type_vals), 0x0,
 187             NULL, HFILL }},
 188
 189         { &hf_pn_mrrt_length,
 190           { "Length", "pn_mrrt.length",
 191             FT_UINT8, BASE_DEC, NULL, 0x0,
 192             NULL, HFILL }},
 193
 194         { &hf_pn_mrrt_version,
 195           { "Version", "pn_mrrt.version",
 196             FT_UINT16, BASE_DEC, NULL, 0x0,
 197             NULL, HFILL }},
 198
 199         { &hf_pn_mrrt_sequence_id,
 200           { "SequenceID", "pn_mrrt.sequence_id",
 201             FT_UINT16, BASE_HEX, NULL, 0x0,
 202             "Unique sequence number to each outstanding service request", HFILL }},
 203
 204         { &hf_pn_mrrt_sa,
 205           { "SA", "pn_mrrt.sa",
 206             FT_ETHER, BASE_NONE, 0x0, 0x0,
 207             NULL, HFILL }},
 208
 209         { &hf_pn_mrrt_domain_uuid,
 210           { "DomainUUID", "pn_mrrt.domain_uuid",
 211             FT_GUID, BASE_NONE, NULL, 0x0,
 212             NULL, HFILL }},
 213
 214     };
 215
 216
 217     static int *ett[] = {
 218         &ett_pn_mrrt
 219     };
 220
 221     proto_pn_mrrt = proto_register_protocol ("PROFINET MRRT", "PN-MRRT", "pn_mrrt");
 222     proto_register_field_array (proto_pn_mrrt, hf, array_length (hf));
 223     proto_register_subtree_array (ett, array_length (ett));
 224 }
 225
 226
 227 void
 228 proto_reg_handoff_pn_mrrt (void)
 229 {
 230
 231     /* register ourself as an heuristic pn-rt payload dissector */
 232     heur_dissector_add("pn_rt", dissect_PNMRRT_Data_heur, "PROFINET MRRT IO", "pn_mrrt_pn_rt", proto_pn_mrrt, HEURISTIC_ENABLE);
 233 }
 234
 235 /*
 236  * Editor modelines  -  https://www.wireshark.org/tools/modelines.html
 237  *
 238  * Local variables:
 239  * c-basic-offset: 4
 240  * tab-width: 8
 241  * indent-tabs-mode: nil
 242  * End:
 243  *
 244  * vi: set shiftwidth=4 tabstop=8 expandtab:
 245  * :indentSize=4:tabSize=8:noTabs=true:
 246  */