2007-05-25 23:40:42 +00:00
|
|
|
/* msg_aas_beam.c
|
|
|
|
* WiMax MAC Management AAS-BEAM-SELECT/REQ/RSP Messages decoders
|
|
|
|
*
|
|
|
|
* Copyright (c) 2007 by Intel Corporation.
|
|
|
|
*
|
|
|
|
* Author: Lu Pan
|
|
|
|
*
|
|
|
|
* $Id$
|
|
|
|
*
|
|
|
|
* Wireshark - Network traffic analyzer
|
|
|
|
* By Gerald Combs <gerald@wireshark.org>
|
|
|
|
* Copyright 1999 Gerald Combs
|
|
|
|
*
|
|
|
|
* This program is free software; you can redistribute it and/or
|
|
|
|
* modify it under the terms of the GNU General Public License
|
|
|
|
* as published by the Free Software Foundation; either version 2
|
|
|
|
* of the License, or (at your option) any later version.
|
|
|
|
*
|
|
|
|
* This program is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
* GNU General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU General Public License
|
|
|
|
* along with this program; if not, write to the Free Software
|
|
|
|
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#define OFDM /* disable it if not supporting OFDM */
|
|
|
|
|
|
|
|
/* Include files */
|
|
|
|
|
|
|
|
#ifdef HAVE_CONFIG_H
|
|
|
|
#include "config.h"
|
|
|
|
#endif
|
|
|
|
|
2007-05-27 18:33:13 +00:00
|
|
|
#include <glib.h>
|
2007-05-25 23:40:42 +00:00
|
|
|
#include <epan/packet.h>
|
|
|
|
#include "wimax_mac.h"
|
|
|
|
|
|
|
|
extern gint proto_mac_mgmt_msg_aas_fbck_decoder;
|
|
|
|
|
|
|
|
#define AAS_BEAM_SELECT_AAS_BEAM_INDEX_MASK 0xFC
|
|
|
|
#define AAS_BEAM_SELECT_RESERVED_MASK 0x03
|
|
|
|
#define AAS_BEAM_FEEDBACK_REQUEST_NUMBER_MASK 0xE0
|
|
|
|
#define AAS_BEAM_MEASUREMENT_REPORT_TYPE_MASK 0x18
|
|
|
|
#define AAS_BEAM_RESOLUTION_PARAMETER_MASK 0x07
|
|
|
|
|
|
|
|
#define AAS_BEAM_BEAM_BIT_MASK_MASK 0xF0
|
|
|
|
#define AAS_BEAM_RESERVED_MASK 0x0F
|
|
|
|
|
|
|
|
static gint proto_mac_mgmt_msg_aas_beam_decoder = -1;
|
|
|
|
static gint ett_mac_mgmt_msg_aas_beam_select_decoder = -1;
|
|
|
|
static gint ett_mac_mgmt_msg_aas_beam_req_decoder = -1;
|
2009-08-04 19:01:34 +00:00
|
|
|
/* static gint ett_mac_mgmt_msg_aas_beam_rsp_decoder = -1; */
|
2007-05-25 23:40:42 +00:00
|
|
|
|
|
|
|
#ifdef OFDM
|
|
|
|
static const value_string vals_report_types[] =
|
|
|
|
{
|
|
|
|
{0, "BEAM_REP_IE"},
|
|
|
|
{0, NULL}
|
|
|
|
};
|
|
|
|
|
|
|
|
static const value_string vals_resolution_parameter[] =
|
|
|
|
{
|
|
|
|
{0, "report every 4th subcarrier"},
|
|
|
|
{1, "report every 8th subcarrier"},
|
|
|
|
{2, "report every 16th subcarrier"},
|
|
|
|
{3, "report every 32nd subcarrier"},
|
|
|
|
{4, "report every 64th subcarrier"},
|
|
|
|
{0, NULL}
|
|
|
|
};
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/* fix fields */
|
|
|
|
static gint hf_aas_beam_message_type = -1;
|
|
|
|
static gint hf_aas_beam_unknown_type = -1;
|
|
|
|
static gint hf_aas_beam_select_index = -1;
|
|
|
|
static gint hf_aas_beam_select_reserved = -1;
|
|
|
|
#ifdef OFDM
|
|
|
|
static gint hf_aas_beam_frame_number = -1;
|
|
|
|
static gint hf_aas_beam_feedback_request_number = -1;
|
|
|
|
static gint hf_aas_beam_measurement_report_type = -1;
|
|
|
|
static gint hf_aas_beam_resolution_parameter = -1;
|
|
|
|
static gint hf_aas_beam_beam_bit_mask = -1;
|
|
|
|
static int hf_aas_beam_freq_value_re = -1;
|
|
|
|
static int hf_aas_beam_freq_value_im = -1;
|
|
|
|
static int hf_aas_beam_rssi_value = -1;
|
|
|
|
static int hf_aas_beam_cinr_value = -1;
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
2007-05-26 20:07:53 +00:00
|
|
|
void dissect_mac_mgmt_msg_aas_beam_select_decoder(tvbuff_t *tvb, packet_info *pinfo _U_, proto_tree *tree)
|
2007-05-25 23:40:42 +00:00
|
|
|
{
|
|
|
|
guint offset = 0;
|
|
|
|
guint tvb_len, payload_type;
|
|
|
|
proto_item *aas_beam_item = NULL;
|
|
|
|
proto_tree *aas_beam_tree = NULL;
|
|
|
|
|
|
|
|
if(tree)
|
|
|
|
{ /* we are being asked for details */
|
|
|
|
/* get the message type */
|
|
|
|
payload_type = tvb_get_guint8(tvb, offset);
|
|
|
|
/* ensure the message type is AAS-BEAM-SELECT */
|
|
|
|
if(payload_type != MAC_MGMT_MSG_AAS_BEAM_SELECT)
|
|
|
|
return;
|
2007-05-27 18:33:13 +00:00
|
|
|
/* Get the tvb reported length */
|
|
|
|
tvb_len = tvb_reported_length(tvb);
|
2007-05-25 23:40:42 +00:00
|
|
|
/* display MAC message type */
|
|
|
|
aas_beam_item = proto_tree_add_protocol_format(tree, proto_mac_mgmt_msg_aas_beam_decoder, tvb, offset, tvb_len, "AAS Beam Select (AAS-BEAM-SELECT) (%u bytes)", tvb_len);
|
|
|
|
/* add subtree */
|
|
|
|
aas_beam_tree = proto_item_add_subtree(aas_beam_item, ett_mac_mgmt_msg_aas_beam_select_decoder);
|
|
|
|
/* Display the AAS-BEAM-SELECT message type */
|
|
|
|
proto_tree_add_item(aas_beam_tree, hf_aas_beam_message_type, tvb, offset, 1, FALSE);
|
|
|
|
/* move to next field */
|
|
|
|
offset++;
|
|
|
|
/* Decode and display the AAS-BEAM-SELECT message body */
|
|
|
|
/* display the AAS Beam Index */
|
|
|
|
proto_tree_add_item(aas_beam_tree, hf_aas_beam_select_index, tvb, offset, 1, FALSE);
|
|
|
|
/* display the reserved fields */
|
|
|
|
proto_tree_add_item(aas_beam_tree, hf_aas_beam_select_reserved, tvb, offset, 1, FALSE);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
#ifdef OFDM
|
2007-05-26 20:07:53 +00:00
|
|
|
static void dissect_mac_mgmt_msg_aas_beam_req_decoder(tvbuff_t *tvb, packet_info *pinfo _U_, proto_tree *tree)
|
2007-05-25 23:40:42 +00:00
|
|
|
{
|
|
|
|
guint offset = 0;
|
|
|
|
guint tvb_len, payload_type;
|
|
|
|
proto_item *aas_beam_item = NULL;
|
|
|
|
proto_tree *aas_beam_tree = NULL;
|
|
|
|
|
|
|
|
if(tree)
|
|
|
|
{ /* we are being asked for details */
|
|
|
|
/* get the message type */
|
|
|
|
payload_type = tvb_get_guint8(tvb, offset);
|
|
|
|
/* ensure the message type is AAS-BEAM-REQ */
|
|
|
|
if(payload_type != MAC_MGMT_MSG_AAS_BEAM_REQ)
|
|
|
|
return;
|
2007-05-27 18:33:13 +00:00
|
|
|
/* Get the tvb reported length */
|
|
|
|
tvb_len = tvb_reported_length(tvb);
|
2007-05-25 23:40:42 +00:00
|
|
|
/* display MAC message type */
|
|
|
|
aas_beam_item = proto_tree_add_protocol_format(tree, proto_mac_mgmt_msg_aas_beam_decoder, tvb, offset, tvb_len, "AAS Beam Request (AAS-BEAM-REQ) (%u bytes)", tvb_len);
|
|
|
|
/* add subtree */
|
|
|
|
aas_beam_tree = proto_item_add_subtree(aas_beam_item, ett_mac_mgmt_msg_aas_beam_req_decoder);
|
|
|
|
/* Display the AAS-BEAM-REQ message type */
|
|
|
|
proto_tree_add_item(aas_beam_tree, hf_aas_beam_message_type, tvb, offset, 1, FALSE);
|
|
|
|
/* move to next field */
|
|
|
|
offset++;
|
|
|
|
/* Decode and display the AAS-BEAM-REQ message body */
|
|
|
|
/* display the Frame Number */
|
|
|
|
proto_tree_add_item(aas_beam_tree, hf_aas_beam_frame_number, tvb, offset, 1, FALSE);
|
|
|
|
/* move to next field */
|
|
|
|
offset++;
|
|
|
|
/* display the Feedback Request Number */
|
|
|
|
proto_tree_add_item(aas_beam_tree, hf_aas_beam_feedback_request_number, tvb, offset, 1, FALSE);
|
|
|
|
/* display the Measurement Report Type */
|
|
|
|
proto_tree_add_item(aas_beam_tree, hf_aas_beam_measurement_report_type, tvb, offset, 1, FALSE);
|
|
|
|
/* display the Resolution Parameter */
|
|
|
|
proto_tree_add_item(aas_beam_tree, hf_aas_beam_resolution_parameter, tvb, offset, 1, FALSE);
|
|
|
|
/* move to next field */
|
|
|
|
offset++;
|
|
|
|
/* display the Beam Bit mask */
|
|
|
|
proto_tree_add_item(aas_beam_tree, hf_aas_beam_beam_bit_mask, tvb, offset, 1, FALSE);
|
|
|
|
/* display the reserved fields */
|
|
|
|
proto_tree_add_item(aas_beam_tree, hf_aas_beam_select_reserved, tvb, offset, 1, FALSE);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2007-05-26 20:07:53 +00:00
|
|
|
static void dissect_mac_mgmt_msg_aas_beam_rsp_decoder(tvbuff_t *tvb, packet_info *pinfo _U_, proto_tree *tree)
|
2007-05-25 23:40:42 +00:00
|
|
|
{
|
|
|
|
guint offset = 0;
|
|
|
|
guint tvb_len, payload_type, report_type;
|
|
|
|
guint number_of_frequencies, index;
|
|
|
|
proto_item *aas_beam_item = NULL;
|
|
|
|
proto_tree *aas_beam_tree = NULL;
|
|
|
|
|
|
|
|
if(tree)
|
|
|
|
{ /* we are being asked for details */
|
|
|
|
/* get the message type */
|
|
|
|
payload_type = tvb_get_guint8(tvb, offset);
|
|
|
|
/* ensure the message type is AAS-BEAM-RSP */
|
|
|
|
if(payload_type != MAC_MGMT_MSG_AAS_BEAM_RSP)
|
|
|
|
return;
|
2007-05-27 18:33:13 +00:00
|
|
|
/* Get the tvb reported length */
|
|
|
|
tvb_len = tvb_reported_length(tvb);
|
2007-05-25 23:40:42 +00:00
|
|
|
/* display MAC message type */
|
|
|
|
aas_beam_item = proto_tree_add_protocol_format(tree, proto_mac_mgmt_msg_aas_beam_decoder, tvb, offset, tvb_len, "AAS Beam Response (AAS-BEAM-RSP) (%u bytes)", tvb_len);
|
|
|
|
/* add subtree */
|
|
|
|
aas_beam_tree = proto_item_add_subtree(aas_beam_item, ett_mac_mgmt_msg_aas_beam_req_decoder);
|
|
|
|
/* Display the AAS-BEAM-RSP message type */
|
|
|
|
proto_tree_add_item(aas_beam_tree, hf_aas_beam_message_type, tvb, offset, 1, FALSE);
|
|
|
|
/* move to next field */
|
|
|
|
offset++;
|
|
|
|
/* Decode and display the AAS-BEAM-RSP message body */
|
|
|
|
/* display the Frame Number */
|
|
|
|
proto_tree_add_item(aas_beam_tree, hf_aas_beam_frame_number, tvb, offset, 1, FALSE);
|
|
|
|
/* move to next field */
|
|
|
|
offset++;
|
|
|
|
/* get the Measurement Report Type */
|
|
|
|
report_type = tvb_get_guint8(tvb, offset);
|
|
|
|
/* display the Feedback Request Number */
|
|
|
|
proto_tree_add_item(aas_beam_tree, hf_aas_beam_feedback_request_number, tvb, offset, 1, FALSE);
|
|
|
|
/* display the Measurement Report Type */
|
|
|
|
proto_tree_add_item(aas_beam_tree, hf_aas_beam_measurement_report_type, tvb, offset, 1, FALSE);
|
|
|
|
/* display the Resolution Parameter */
|
|
|
|
proto_tree_add_item(aas_beam_tree, hf_aas_beam_resolution_parameter, tvb, offset, 1, FALSE);
|
|
|
|
/* move to next field */
|
|
|
|
offset++;
|
|
|
|
/* display the Beam Bit mask */
|
|
|
|
proto_tree_add_item(aas_beam_tree, hf_aas_beam_beam_bit_mask, tvb, offset, 1, FALSE);
|
|
|
|
/* display the reserved fields */
|
|
|
|
proto_tree_add_item(aas_beam_tree, hf_aas_beam_select_reserved, tvb, offset, 1, FALSE);
|
|
|
|
/* move to next field */
|
|
|
|
offset++;
|
|
|
|
/* check the Measurement Report Type */
|
|
|
|
if((report_type & AAS_BEAM_MEASUREMENT_REPORT_TYPE_MASK) == 0)
|
|
|
|
{
|
|
|
|
/* calculate the total number of frequencies */
|
|
|
|
number_of_frequencies = (tvb_len - offset) / 2 - 1;
|
|
|
|
/* display the frequency */
|
|
|
|
for(index = 0; index < number_of_frequencies; index++)
|
|
|
|
{ /* display the Frequency Value (real part) */
|
|
|
|
proto_tree_add_item(aas_beam_tree, hf_aas_beam_freq_value_re, tvb, offset, 1, FALSE);
|
|
|
|
/* move to next field */
|
|
|
|
offset++;
|
|
|
|
/* display the Frequency Value (imaginary part) */
|
|
|
|
proto_tree_add_item(aas_beam_tree, hf_aas_beam_freq_value_im, tvb, offset, 1, FALSE);
|
|
|
|
/* move to next field */
|
|
|
|
offset++;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
/* display the RSSI Mean Value */
|
|
|
|
proto_tree_add_item(aas_beam_tree, hf_aas_beam_rssi_value, tvb, offset, 1, FALSE);
|
|
|
|
/* move to next field */
|
|
|
|
offset++;
|
|
|
|
/* display the CINR Mean Value */
|
|
|
|
proto_tree_add_item(aas_beam_tree, hf_aas_beam_cinr_value, tvb, offset, 1, FALSE);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
#endif
|
2009-08-04 19:01:34 +00:00
|
|
|
|
|
|
|
/* Register Wimax Mac Payload Protocol and Dissector */
|
|
|
|
void proto_register_mac_mgmt_msg_aas_beam(void)
|
|
|
|
{
|
|
|
|
/* AAS-BEAM display */
|
|
|
|
static hf_register_info hf_aas_beam[] =
|
|
|
|
{
|
|
|
|
{
|
|
|
|
&hf_aas_beam_message_type,
|
|
|
|
{
|
|
|
|
"MAC Management Message Type", "wmx.macmgtmsgtype.aas_beam",
|
|
|
|
FT_UINT8, BASE_DEC, NULL, 0x0, NULL, HFILL
|
|
|
|
}
|
|
|
|
},
|
|
|
|
{
|
|
|
|
&hf_aas_beam_select_index,
|
|
|
|
{
|
|
|
|
"AAS Beam Index", "wmx.aas_beam.aas_beam_index",
|
|
|
|
FT_UINT8, BASE_DEC, NULL, AAS_BEAM_SELECT_AAS_BEAM_INDEX_MASK, NULL, HFILL
|
|
|
|
}
|
|
|
|
},
|
|
|
|
{
|
|
|
|
&hf_aas_beam_beam_bit_mask,
|
|
|
|
{
|
|
|
|
"Beam Bit Mask", "wmx.aas_beam.beam_bit_mask",
|
|
|
|
FT_UINT8, BASE_HEX, NULL, AAS_BEAM_BEAM_BIT_MASK_MASK, NULL, HFILL
|
|
|
|
}
|
|
|
|
},
|
|
|
|
#ifdef OFDM
|
|
|
|
{
|
|
|
|
&hf_aas_beam_cinr_value,
|
|
|
|
{
|
|
|
|
"CINR Mean Value", "wmx.aas_beam.cinr_mean_value",
|
|
|
|
FT_UINT8, BASE_DEC, NULL, 0x0, NULL, HFILL
|
|
|
|
}
|
|
|
|
},
|
|
|
|
{
|
|
|
|
&hf_aas_beam_feedback_request_number,
|
|
|
|
{
|
|
|
|
"Feedback Request Number", "wmx.aas_beam.feedback_request_number",
|
|
|
|
FT_UINT8, BASE_DEC, NULL, AAS_BEAM_FEEDBACK_REQUEST_NUMBER_MASK, NULL, HFILL
|
|
|
|
}
|
|
|
|
},
|
|
|
|
{
|
|
|
|
&hf_aas_beam_frame_number,
|
|
|
|
{
|
|
|
|
"Frame Number", "wmx.aas_beam.frame_number",
|
|
|
|
FT_UINT8, BASE_DEC, NULL, 0x0, NULL, HFILL
|
|
|
|
}
|
|
|
|
},
|
|
|
|
{
|
|
|
|
&hf_aas_beam_freq_value_im,
|
|
|
|
{
|
|
|
|
"Frequency Value (imaginary part)", "wmx.aas_beam.freq_value_im",
|
|
|
|
FT_UINT8, BASE_DEC, NULL, 0x0, NULL, HFILL
|
|
|
|
}
|
|
|
|
},
|
|
|
|
{
|
|
|
|
&hf_aas_beam_freq_value_re,
|
|
|
|
{
|
|
|
|
"Frequency Value (real part)", "wmx.aas_beam.freq_value_re",
|
|
|
|
FT_UINT8, BASE_DEC, NULL, 0x0, NULL, HFILL
|
|
|
|
}
|
|
|
|
},
|
|
|
|
{
|
|
|
|
&hf_aas_beam_measurement_report_type,
|
|
|
|
{
|
|
|
|
"Measurement Report Type", "wmx.aas_beam.measurement_report_type",
|
|
|
|
FT_UINT8, BASE_DEC, VALS(vals_report_types), AAS_BEAM_MEASUREMENT_REPORT_TYPE_MASK, NULL, HFILL
|
|
|
|
}
|
|
|
|
},
|
|
|
|
{
|
|
|
|
&hf_aas_beam_select_reserved,
|
|
|
|
{
|
|
|
|
"Reserved", "wmx.aas_beam.reserved",
|
|
|
|
FT_UINT8, BASE_HEX, NULL, AAS_BEAM_SELECT_RESERVED_MASK, NULL, HFILL
|
|
|
|
}
|
|
|
|
},
|
|
|
|
{
|
|
|
|
&hf_aas_beam_resolution_parameter,
|
|
|
|
{
|
|
|
|
"Resolution Parameter", "wmx.aas_beam.resolution_parameter",
|
|
|
|
FT_UINT8, BASE_DEC, VALS(vals_resolution_parameter), AAS_BEAM_RESOLUTION_PARAMETER_MASK, NULL, HFILL
|
|
|
|
}
|
|
|
|
},
|
|
|
|
{
|
|
|
|
&hf_aas_beam_rssi_value,
|
|
|
|
{
|
|
|
|
"RSSI Mean Value", "wmx.aas_beam.rssi_mean_value",
|
|
|
|
FT_UINT8, BASE_DEC, NULL, 0x0, NULL, HFILL
|
|
|
|
}
|
|
|
|
},
|
|
|
|
#endif
|
|
|
|
{
|
|
|
|
&hf_aas_beam_unknown_type,
|
|
|
|
{
|
|
|
|
"Unknown TLV type", "wmx.aas_beam.unknown_type",
|
|
|
|
FT_BYTES, BASE_NONE, NULL, 0x0, NULL, HFILL
|
|
|
|
}
|
|
|
|
}
|
|
|
|
};
|
|
|
|
|
|
|
|
/* Setup protocol subtree array */
|
|
|
|
static gint *ett[] =
|
|
|
|
{
|
|
|
|
&ett_mac_mgmt_msg_aas_beam_select_decoder,
|
|
|
|
&ett_mac_mgmt_msg_aas_beam_req_decoder,
|
|
|
|
/* &ett_mac_mgmt_msg_aas_beam_rsp_decoder, */
|
|
|
|
};
|
|
|
|
|
|
|
|
proto_mac_mgmt_msg_aas_beam_decoder = proto_mac_mgmt_msg_aas_fbck_decoder;
|
|
|
|
|
|
|
|
proto_register_field_array(proto_mac_mgmt_msg_aas_beam_decoder, hf_aas_beam, array_length(hf_aas_beam));
|
|
|
|
proto_register_subtree_array(ett, array_length(ett));
|
|
|
|
|
|
|
|
register_dissector("mac_mgmt_msg_aas_beam_select_handler", dissect_mac_mgmt_msg_aas_beam_select_decoder, -1);
|
|
|
|
#ifdef OFDM
|
|
|
|
register_dissector("mac_mgmt_msg_aas_beam_req_handler", dissect_mac_mgmt_msg_aas_beam_req_decoder, -1);
|
|
|
|
register_dissector("mac_mgmt_msg_aas_beam_rsp_handler", dissect_mac_mgmt_msg_aas_beam_rsp_decoder, -1);
|
|
|
|
#endif
|
|
|
|
}
|