plugins/wimax/msg_fpc.c

   1 /* msg_fpc.c
   2  * WiMax MAC Management FPC Message decoder
   3  *
   4  * Copyright (c) 2007 by Intel Corporation.
   5  *
   6  * Author: John R. Underwood <junderx@yahoo.com>
   7  *
   8  * $Id$
   9  *
  10  * Wireshark - Network traffic analyzer
  11  * By Gerald Combs <gerald@wireshark.org>
  12  * Copyright 1999 Gerald Combs
  13  *
  14  * This program is free software; you can redistribute it and/or
  15  * modify it under the terms of the GNU General Public License
  16  * as published by the Free Software Foundation; either version 2
  17  * of the License, or (at your option) any later version.
  18  *
  19  * This program is distributed in the hope that it will be useful,
  20  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  21  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  22  * GNU General Public License for more details.
  23  *
  24  * You should have received a copy of the GNU General Public License
  25  * along with this program; if not, write to the Free Software
  26  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  27  */
  28
  29 /* Include files */
  30
  31 #include "config.h"
  32
  33 #include <glib.h>
  34 #include <epan/packet.h>
  35 #include "crc.h"
  36 #include "wimax_tlv.h"
  37 #include "wimax_mac.h"
  38
  39 static gint proto_mac_mgmt_msg_fpc_decoder = -1;
  40
  41 static gint ett_mac_mgmt_msg_fpc_decoder = -1;
  42
  43 /* FPC fields */
  44 static gint hf_fpc_number_of_stations = -1;
  45 static gint hf_fpc_basic_cid = -1;
  46 static gint hf_fpc_power_adjust = -1;
  47 static gint hf_fpc_power_measurement_frame = -1;
  48 /* static gint hf_fpc_invalid_tlv = -1; */
  49
  50
  51 /* Decode FPC messages. */
  52 static void dissect_mac_mgmt_msg_fpc_decoder(tvbuff_t *tvb, packet_info *pinfo _U_, proto_tree *tree)
  53 {
  54         guint offset = 0;
  55         guint i;
  56         guint number_stations;
  57         guint tvb_len;
  58         proto_item *fpc_item;
  59         proto_tree *fpc_tree;
  60         gint8 value;
  61         gfloat power_change;
  62
  63         {       /* we are being asked for details */
  64
  65                 /* Get the tvb reported length */
  66                 tvb_len =  tvb_reported_length(tvb);
  67                 /* display MAC payload type FPC */
  68                 fpc_item = proto_tree_add_protocol_format(tree, proto_mac_mgmt_msg_fpc_decoder, tvb, 0, -1, "MAC Management Message, FPC");
  69                 /* add MAC FPC subtree */
  70                 fpc_tree = proto_item_add_subtree(fpc_item, ett_mac_mgmt_msg_fpc_decoder);
  71
  72                 /* display the Number of stations */
  73                 proto_tree_add_item(fpc_tree, hf_fpc_number_of_stations, tvb, offset, 1, ENC_BIG_ENDIAN);
  74
  75                 number_stations = tvb_get_guint8(tvb, offset);
  76                 offset++;
  77                 for (i = 0; ((i < number_stations) && (offset >= tvb_len)); i++ ) {
  78                         /* display the Basic CID*/
  79                         proto_tree_add_item(fpc_tree, hf_fpc_basic_cid, tvb, offset, 2, ENC_BIG_ENDIAN);
  80                         offset += 2;
  81
  82                         /* display the Power adjust value */
  83                         value = (gint8)tvb_get_guint8(tvb, offset);
  84                         power_change = (float)0.25 * value;  /* 0.25dB incr */
  85
  86                         /* display the Power adjust value in dB */
  87                         proto_tree_add_float_format_value(fpc_tree, hf_fpc_power_adjust, tvb, offset, 1, power_change, " %.2f dB", power_change);
  88                         offset++;
  89
  90                         /* display the Power measurement frame */
  91                         proto_tree_add_item(fpc_tree, hf_fpc_power_measurement_frame, tvb, offset, 1, ENC_BIG_ENDIAN);
  92                         offset++;
  93                 }
  94         }
  95 }
  96
  97 /* Register Wimax Mac Payload Protocol and Dissector */
  98 void proto_register_mac_mgmt_msg_fpc(void)
  99 {
 100         /* FPC fields display */
 101         static hf_register_info hf[] =
 102         {
 103                 {
 104                         &hf_fpc_basic_cid,
 105                         {
 106                                 "Basic CID", "wmx.fpc.basic_cid",
 107                                 FT_UINT16, BASE_DEC, NULL, 0x0, NULL, HFILL
 108                         }
 109                 },
 110 #if 0
 111                 {
 112                         &hf_fpc_invalid_tlv,
 113                         {
 114                                 "Invalid TLV", "wmx.fpc.invalid_tlv",
 115                                 FT_BYTES, BASE_NONE, NULL, 0, NULL, HFILL
 116                         }
 117                 },
 118 #endif
 119                 {
 120                         &hf_fpc_number_of_stations,
 121                         {
 122                                 "Number of stations", "wmx.fpc.number_stations",
 123                                 FT_UINT8, BASE_DEC, NULL, 0x0, NULL, HFILL
 124                         }
 125                 },
 126                 {
 127                         &hf_fpc_power_adjust,
 128                         {
 129                                 "Power Adjust", "wmx.fpc.power_adjust",
 130                                 FT_FLOAT, BASE_NONE, NULL, 0x0, "Signed change in power level (incr of 0.25dB) that the SS shall apply to its current power setting", HFILL
 131                         }
 132                 },
 133                 {
 134                         &hf_fpc_power_measurement_frame,
 135                         {
 136                                 "Power measurement frame", "wmx.fpc.power_measurement_frame",
 137                                 FT_INT8, BASE_DEC, NULL, 0x0, "The 8 LSB of the frame number in which the BS measured the power corrections referred to in the message", HFILL
 138                         }
 139                 }
 140         };
 141
 142         /* Setup protocol subtree array */
 143         static gint *ett[] =
 144                 {
 145                         &ett_mac_mgmt_msg_fpc_decoder,
 146                 };
 147
 148         proto_mac_mgmt_msg_fpc_decoder = proto_register_protocol (
 149                 "WiMax FPC Message", /* name       */
 150                 "WiMax FPC (fpc)",   /* short name */
 151                 "wmx.fpc"            /* abbrev     */
 152                 );
 153
 154         proto_register_field_array(proto_mac_mgmt_msg_fpc_decoder, hf, array_length(hf));
 155         proto_register_subtree_array(ett, array_length(ett));
 156 }
 157
 158 void
 159 proto_reg_handoff_mac_mgmt_msg_fpc(void)
 160 {
 161         dissector_handle_t fpc_handle;
 162
 163         fpc_handle = create_dissector_handle(dissect_mac_mgmt_msg_fpc_decoder, proto_mac_mgmt_msg_fpc_decoder);
 164         dissector_add_uint("wmx.mgmtmsg", MAC_MGMT_MSG_FPC, fpc_handle);
 165 }