wireshark/plugins/epan/wimax/msg_rng_rsp.c

964 lines
35 KiB
C

/* msg_rng_rsp.c
* WiMax MAC Management RNG-RSP Message decoder
*
* Copyright (c) 2007 by Intel Corporation.
*
* Author: John R. Underwood <junderx@yahoo.com>
*
* Wireshark - Network traffic analyzer
* By Gerald Combs <gerald@wireshark.org>
* Copyright 1999 Gerald Combs
*
* SPDX-License-Identifier: GPL-2.0-or-later
*/
/* Include files */
#include "config.h"
#include <epan/packet.h>
#include "wimax_tlv.h"
#include "wimax_mac.h"
#include "wimax_utils.h"
void proto_register_mac_mgmt_msg_rng_rsp(void);
void proto_reg_handoff_mac_mgmt_msg_rng_rsp(void);
extern gboolean include_cor2_changes;
static dissector_handle_t sbc_rsp_handle = NULL;
static dissector_handle_t reg_rsp_handle = NULL;
static gint proto_mac_mgmt_msg_rng_rsp_decoder = -1;
static gint ett_mac_mgmt_msg_rng_rsp_decoder = -1;
static gint ett_rng_rsp_message_tree = -1;
/* RNG-RSP fields */
static gint hf_rng_req_reserved = -1;
/* static gint hf_rng_rsp_ul_channel_id = -1; */
static gint hf_rng_rsp_timing_adjust = -1;
static gint hf_rng_rsp_power_level_adjust = -1;
static gint hf_rng_rsp_offset_freq_adjust = -1;
static gint hf_rng_rsp_ranging_status = -1;
static gint hf_rng_rsp_dl_freq_override = -1;
static gint hf_rng_rsp_ul_chan_id_override = -1;
static gint hf_rng_rsp_dl_operational_burst_profile = -1;
static gint hf_rng_rsp_dl_operational_burst_profile_diuc = -1;
static gint hf_rng_rsp_dl_operational_burst_profile_ccc = -1;
static gint hf_rng_rsp_ss_mac_address = -1;
static gint hf_rng_rsp_basic_cid = -1;
static gint hf_rng_rsp_primary_mgmt_cid = -1;
static gint hf_rng_rsp_broadcast = -1;
static gint hf_rng_rsp_frame_number = -1;
static gint hf_rng_rsp_opportunity_number = -1;
static gint hf_rng_rsp_service_level_prediction = -1;
static gint hf_rng_rsp_resource_retain_flag = -1;
static gint hf_rng_rsp_ho_process_optimization = -1;
static gint hf_rng_rsp_ho_process_optimization_0 = -1;
static gint hf_rng_rsp_ho_process_optimization_1_2 = -1;
static gint hf_rng_rsp_ho_process_optimization_3 = -1;
static gint hf_rng_rsp_ho_process_optimization_4 = -1;
static gint hf_rng_rsp_ho_process_optimization_5 = -1;
static gint hf_rng_rsp_ho_process_optimization_6 = -1;
static gint hf_rng_rsp_ho_process_optimization_7 = -1;
static gint hf_rng_rsp_ho_process_optimization_8 = -1;
static gint hf_rng_rsp_ho_process_optimization_9 = -1;
static gint hf_rng_rsp_ho_process_optimization_10 = -1;
static gint hf_rng_rsp_ho_process_optimization_11 = -1;
static gint hf_rng_rsp_ho_process_optimization_12 = -1;
static gint hf_rng_rsp_ho_process_optimization_13 = -1;
static gint hf_rng_rsp_ho_process_optimization_14 = -1;
static gint hf_rng_rsp_ho_process_optimization_15 = -1;
/* Added the following to help implement RNG-RSP message encoding 33 (Table 367 in IEEE 802.16e-2007) */
static gint hf_rng_rsp_dl_op_burst_profile_ofdma = -1;
static gint hf_rng_rsp_least_robust_diuc = -1;
static gint hf_rng_rsp_repetition_coding_indication = -1;
static gint hf_rng_rsp_config_change_count_of_dcd = -1;
/* Added the following to help implement RNG-RSP message encoding 22 (Table 367 in IEEE 802.16e-2007) */
static gint hf_rng_rsp_ho_id = -1;
static gint hf_rng_rsp_location_update_response = -1;
/* Added the following to help implement RNG-RSP message encoding 24 (Table 367 in IEEE 802.16e-2007) */
static gint hf_rng_rsp_paging_information = -1;
static gint hf_rng_rsp_paging_cycle = -1;
static gint hf_rng_rsp_paging_offset = -1;
static gint hf_rng_rsp_paging_group_id = -1;
static gint hf_rng_rsp_bs_random = -1;
static gint hf_rng_rsp_akid = -1;
static gint hf_rng_rsp_ranging_subchan = -1;
static gint hf_rng_rsp_time_symbol_reference = -1;
static gint hf_rng_rsp_subchannel_reference = -1;
static gint hf_rng_rsp_ranging_code_index = -1;
static gint hf_rng_rsp_frame_number2 = -1;
static gint hf_tlv_type = -1;
/* static gint hf_tlv_value = -1; */
static gint hf_rng_invalid_tlv = -1;
/* STRING RESOURCES */
static const true_false_string tfs_rng_rsp_aas_broadcast = {
"SS shall not issue contention-based Bandwidth Request",
"SS may issue contention-based Bandwidth Request"
};
static const true_false_string tfs_rng_rsp_resource_retain_flag = {
"Retained by the BS",
"Deleted by the BS"
};
static const value_string vals_rng_rsp_ranging_status[] = {
{1, "continue"},
{2, "abort"},
{3, "success"},
{4, "rerange"},
{0, NULL}
};
static const value_string vals_rng_rsp_level_of_service[] = {
{0, "No service possible for this MS"},
{1, "Some service is available for one or"
" several service flows authorized for the MS"},
{2, "For each authorized service flow, a MAC"
" connection can be established with QoS"
" specified by the AuthorizedQoSParamSet"},
{3, "No service level prediction available"},
{0, NULL}
};
static const value_string vals_rng_rsp_ho_process_optimization_0[] = {
{0, "SBC-REQ management messages during current re-entry"
" processing required"},
{1, "Omit SBC-REQ management messages during current"
" re-entry processing"},
{0, NULL},
};
static const value_string vals_rng_rsp_ho_process_optimization_1_2[] = {
{0, "Perform re-authentication and SA-TEK 3-way handshake."
" BS should include SA-TEK-Update TLV in the"
" SA-TEK-Response message. In addition, the RNG-RSP"
" message does not include SA-TEK-Update TLV or SA"
" Challenge Tuple TLV."},
{1, "SA-TEK-Update TLV is included in the RNG-RSP message."
" In this case, SA-TEK 3-way handshake is avoided and"
" SA Challenge Tuple TLV shall not be included in the"
" RNG-RSP message."},
{2, "Reserved"},
{3, "Re-authentication and SA-TEK 3-way handshake is not"
" performed. The RNG-RSP message does not include"
" SA-TEK-Update TLV nor SA Challenge Tuple TLV. All the"
" TEKs received from the serving BS are reused"},
{0, NULL}
};
static const value_string vals_rng_rsp_ho_process_optimization_3[] = {
{0, "Network Address Acquisition management messages during"
" current reentry processing required"},
{1, "Omit Network Address Acquisition management messages"
" during current reentry processing"},
{0, NULL}
};
static const value_string vals_rng_rsp_ho_process_optimization_4[] = {
{0, "Time of Day Acquisition management messages during"
" current reentry processing required"},
{1, "Omit Time of Day Acquisition management messages"
" during current reentry processing"},
{0, NULL}
};
static const value_string vals_rng_rsp_ho_process_optimization_5[] = {
{0, "TFTP management messages during current re-entry"
" processing required"},
{1, "Omit TFTP management messages during current re-entry"
" processing"},
{0, NULL}
};
static const value_string vals_rng_rsp_ho_process_optimization_6[] = {
{0, "Full service and operational state transfer or sharing"
" between Serving BS and Target BS required"},
{1, "Omit Full service and operational state transfer or"
" sharing between Serving BS and Target BS"},
{0, NULL}
};
static const value_string vals_rng_rsp_ho_process_optimization_7[] = {
{0, "REG-REQ management message during current re-entry"
" processing required"},
{1, "Omit REG-REQ management message during current re-entry"
" processing"},
{0, NULL}
};
static const value_string vals_rng_rsp_ho_process_optimization_8[] = {
{0, "BS shall send not send an unsolicited SBC-RSP"
" management message"},
{1, "BS shall send an unsolicited SBC-RSP management message"},
{0, NULL}
};
static const value_string vals_rng_rsp_ho_process_optimization_9[] = {
{0, "No post-HO re-entry MS DL data pending at target BS"},
{1, "post-HO re-entry MS DL data pending at target BS"},
{0, NULL}
};
static const value_string vals_rng_rsp_ho_process_optimization_10[] = {
{0, "BS shall not send an unsolicited REG-RSP management"
" message"},
{1, "BS shall send an unsolicited REG-RSP management message"},
{0, NULL}
};
static const value_string vals_rng_rsp_ho_process_optimization_11[] = {
{0, "(Target) BS does not support virtual SDU SN"},
{1, "(Target} BS supports virtual SDU SN"},
{0, NULL}
};
static const value_string vals_rng_rsp_ho_process_optimization_12[] = {
{0, "MS shall not send a notification of MS's successful"
" re-entry registration"},
{1, "MS shall send a notification of MS's successful"
" re-entry registration"},
{0, NULL}
};
static const value_string vals_rng_rsp_ho_process_optimization_13[] = {
{0, "MS shall not trigger a higher layer protocol required"
" to refresh its traffic IP address"},
{1, "MS shall trigger a higher layer protocol required to"
" refresh its traffic IP address"},
{0, NULL}
};
static const value_string vals_rng_rsp_repetition_coding_indication[] = {
{0, "No repetition coding"},
{1, "Repetition coding of 2"},
{2, "Repetition coding of 4"},
{3, "Repetition coding of 6"},
{0, NULL}
};
static const value_string vals_rng_rsp_location_update_response[] = {
{0, "Success of Location Update"},
{1, "Failure of Location Update"},
{3, "Success of location update and DL traffic pending"},
{4, "Reserved"},
{0, NULL}
};
/* Decode RNG-RSP messages. */
static int dissect_mac_mgmt_msg_rng_rsp_decoder(tvbuff_t *tvb, packet_info *pinfo, proto_tree *tree, void* data _U_)
{
proto_item *ranging_status_item = NULL;
proto_item *dl_freq_override_item = NULL;
proto_item *ss_mac_address_item = NULL;
proto_item *frame_number_item = NULL;
proto_item *opportunity_number_item = NULL;
guint offset = 0;
guint tlv_offset;
guint tvb_len;
proto_item *rng_rsp_item, *sub_item;
proto_item *tlv_item = NULL;
proto_tree *rng_rsp_tree;
proto_tree *sub_tree = NULL;
tlv_info_t tlv_info;
gint tlv_type;
guint tlv_len;
guint this_offset = 0;
tlv_info_t sub_tlv_info;
gint sub_tlv_type;
gint sub_tlv_len;
guint sub_tlv_offset;
float timing_adjust;
float power_level_adjust;
{ /* we are being asked for details */
/* Get the tvb reported length */
tvb_len = tvb_reported_length(tvb);
/* display MAC payload type RNG-RSP */
rng_rsp_item = proto_tree_add_protocol_format(tree, proto_mac_mgmt_msg_rng_rsp_decoder, tvb, offset, tvb_len, "MAC Management Message, RNG-RSP");
/* add MAC RNG-RSP subtree */
rng_rsp_tree = proto_item_add_subtree(rng_rsp_item, ett_mac_mgmt_msg_rng_rsp_decoder);
proto_tree_add_item(rng_rsp_tree, hf_rng_req_reserved, tvb, offset, 1, ENC_BIG_ENDIAN);
offset += 1;
while(offset < tvb_len)
{
/* Get the TLV data. */
init_tlv_info(&tlv_info, tvb, offset);
/* get the TLV type */
tlv_type = get_tlv_type(&tlv_info);
/* get the TLV length */
tlv_len = get_tlv_length(&tlv_info);
if(tlv_type == -1 || tlv_len > MAX_TLV_LEN || tlv_len < 1)
{ /* invalid tlv info */
col_append_sep_str(pinfo->cinfo, COL_INFO, NULL, "RNG-RSP TLV error");
proto_tree_add_item(rng_rsp_tree, hf_rng_invalid_tlv, tvb, offset, (tvb_len - offset), ENC_NA);
break;
}
/* get the offset to the TLV data */
tlv_offset = offset + get_tlv_value_offset(&tlv_info);
switch (tlv_type) {
case RNG_RSP_TIMING_ADJUST: {
sub_tree = add_tlv_subtree_no_item(&tlv_info, rng_rsp_tree, hf_rng_rsp_timing_adjust, tvb, offset);
timing_adjust = (float)(tvb_get_ntohl(tvb, tlv_offset) / 4.0);
tlv_item = proto_tree_add_float_format_value(sub_tree, hf_rng_rsp_timing_adjust, tvb,
tlv_offset, 4, timing_adjust, " %.2f modulation symbols", timing_adjust);
if ((timing_adjust < -2) || (timing_adjust > 2))
proto_item_append_text(tlv_item, " (during periodic ranging shall not exceed +- 2)");
break;
}
case RNG_RSP_POWER_LEVEL_ADJUST: {
sub_tree = add_tlv_subtree_no_item(&tlv_info, rng_rsp_tree, hf_rng_rsp_power_level_adjust, tvb, offset);
power_level_adjust = (float)(tvb_get_guint8(tvb, tlv_offset) / 4.0);
proto_tree_add_float_format_value(sub_tree, hf_rng_rsp_power_level_adjust, tvb, tlv_offset, 1,
power_level_adjust, " %.2f dB", power_level_adjust);
break;
}
case RNG_RSP_OFFSET_FREQ_ADJUST: {
add_tlv_subtree(&tlv_info, rng_rsp_tree, hf_rng_rsp_offset_freq_adjust, tvb, offset, ENC_BIG_ENDIAN);
break;
}
case RNG_RSP_RANGING_STATUS:
ranging_status_item = add_tlv_subtree(&tlv_info, rng_rsp_tree, hf_rng_rsp_ranging_status, tvb, offset, ENC_BIG_ENDIAN);
break;
case RNG_RSP_DL_FREQ_OVERRIDE: {
dl_freq_override_item = add_tlv_subtree(&tlv_info, rng_rsp_tree, hf_rng_rsp_dl_freq_override, tvb, offset, ENC_BIG_ENDIAN);
break;
}
case RNG_RSP_UL_CHANNEL_ID_OVERRIDE:
add_tlv_subtree(&tlv_info, rng_rsp_tree, hf_rng_rsp_ul_chan_id_override, tvb, offset, ENC_BIG_ENDIAN);
break;
case RNG_RSP_DL_OPERATIONAL_BURST_PROFILE:
sub_item = add_tlv_subtree(&tlv_info, rng_rsp_tree, hf_rng_rsp_dl_operational_burst_profile, tvb, offset, ENC_BIG_ENDIAN);
sub_tree = proto_item_add_subtree(sub_item, ett_rng_rsp_message_tree);
proto_tree_add_item(sub_tree, hf_rng_rsp_dl_operational_burst_profile_diuc, tvb, tlv_offset, 2, ENC_BIG_ENDIAN);
proto_tree_add_item(sub_tree, hf_rng_rsp_dl_operational_burst_profile_ccc, tvb, tlv_offset, 2, ENC_BIG_ENDIAN);
break;
case RNG_RSP_SS_MAC_ADDRESS:
if (tlv_len == 6)
{
ss_mac_address_item = add_tlv_subtree(&tlv_info, rng_rsp_tree, hf_rng_rsp_ss_mac_address, tvb, offset, ENC_NA);
} else {
add_tlv_subtree(&tlv_info, rng_rsp_tree, hf_rng_invalid_tlv, tvb, offset, ENC_NA);
}
break;
case RNG_RSP_BASIC_CID:
add_tlv_subtree(&tlv_info, rng_rsp_tree, hf_rng_rsp_basic_cid, tvb, offset, ENC_BIG_ENDIAN);
break;
case RNG_RSP_PRIMARY_MGMT_CID:
add_tlv_subtree(&tlv_info, rng_rsp_tree, hf_rng_rsp_primary_mgmt_cid, tvb, offset, ENC_BIG_ENDIAN);
break;
case RNG_RSP_AAS_BROADCAST_PERMISSION:
add_tlv_subtree(&tlv_info, rng_rsp_tree, hf_rng_rsp_broadcast, tvb, offset, ENC_BIG_ENDIAN);
break;
case RNG_RSP_FRAME_NUMBER:
frame_number_item = add_tlv_subtree(&tlv_info, rng_rsp_tree, hf_rng_rsp_frame_number, tvb, offset, ENC_BIG_ENDIAN);
break;
case RNG_RSP_OPPORTUNITY_NUMBER:
opportunity_number_item = add_tlv_subtree(&tlv_info, rng_rsp_tree, hf_rng_rsp_opportunity_number, tvb, offset, ENC_BIG_ENDIAN);
if (tvb_get_ntohl(tvb, tlv_offset) == 0)
proto_item_append_text(opportunity_number_item, " (may not be 0!)");
break;
case RNG_RSP_SERVICE_LEVEL_PREDICTION:
add_tlv_subtree(&tlv_info, rng_rsp_tree, hf_rng_rsp_service_level_prediction, tvb, offset, ENC_BIG_ENDIAN);
break;
case RNG_RSP_RESOURCE_RETAIN_FLAG:
add_tlv_subtree(&tlv_info, rng_rsp_tree, hf_rng_rsp_resource_retain_flag, tvb, offset, ENC_BIG_ENDIAN);
break;
case RNG_RSP_HO_PROCESS_OPTIMIZATION:
sub_item = add_tlv_subtree(&tlv_info, rng_rsp_tree, hf_rng_rsp_ho_process_optimization, tvb, offset, ENC_BIG_ENDIAN);
sub_tree = proto_item_add_subtree(sub_item, ett_rng_rsp_message_tree);
proto_tree_add_item(sub_tree, hf_rng_rsp_ho_process_optimization_0, tvb, tlv_offset, 2, ENC_BIG_ENDIAN);
proto_tree_add_item(sub_tree, hf_rng_rsp_ho_process_optimization_1_2, tvb, tlv_offset, 2, ENC_BIG_ENDIAN);
proto_tree_add_item(sub_tree, hf_rng_rsp_ho_process_optimization_3, tvb, tlv_offset, 2, ENC_BIG_ENDIAN);
proto_tree_add_item(sub_tree, hf_rng_rsp_ho_process_optimization_4, tvb, tlv_offset, 2, ENC_BIG_ENDIAN);
proto_tree_add_item(sub_tree, hf_rng_rsp_ho_process_optimization_5, tvb, tlv_offset, 2, ENC_BIG_ENDIAN);
proto_tree_add_item(sub_tree, hf_rng_rsp_ho_process_optimization_6, tvb, tlv_offset, 2, ENC_BIG_ENDIAN);
proto_tree_add_item(sub_tree, hf_rng_rsp_ho_process_optimization_7, tvb, tlv_offset, 2, ENC_BIG_ENDIAN);
proto_tree_add_item(sub_tree, hf_rng_rsp_ho_process_optimization_8, tvb, tlv_offset, 2, ENC_BIG_ENDIAN);
proto_tree_add_item(sub_tree, hf_rng_rsp_ho_process_optimization_9, tvb, tlv_offset, 2, ENC_BIG_ENDIAN);
proto_tree_add_item(sub_tree, hf_rng_rsp_ho_process_optimization_10, tvb, tlv_offset, 2, ENC_BIG_ENDIAN);
proto_tree_add_item(sub_tree, hf_rng_rsp_ho_process_optimization_11, tvb, tlv_offset, 2, ENC_BIG_ENDIAN);
proto_tree_add_item(sub_tree, hf_rng_rsp_ho_process_optimization_12, tvb, tlv_offset, 2, ENC_BIG_ENDIAN);
proto_tree_add_item(sub_tree, hf_rng_rsp_ho_process_optimization_13, tvb, tlv_offset, 2, ENC_BIG_ENDIAN);
proto_tree_add_item(sub_tree, hf_rng_rsp_ho_process_optimization_14, tvb, tlv_offset, 2, ENC_BIG_ENDIAN);
proto_tree_add_item(sub_tree, hf_rng_rsp_ho_process_optimization_15, tvb, tlv_offset, 2, ENC_BIG_ENDIAN);
break;
case RNG_RSP_SBC_RSP_ENCODINGS:
sub_tree = add_protocol_subtree(&tlv_info, ett_rng_rsp_message_tree, rng_rsp_tree, proto_mac_mgmt_msg_rng_rsp_decoder, tvb, offset, tlv_len, "SBC-RSP Encodings");
call_dissector(sbc_rsp_handle, tvb_new_subset_length(tvb, tlv_offset, tlv_len), pinfo, sub_tree);
break;
case RNG_RSP_REG_RSP_ENCODINGS:
sub_tree = add_protocol_subtree(&tlv_info, ett_rng_rsp_message_tree, rng_rsp_tree, proto_mac_mgmt_msg_rng_rsp_decoder, tvb, offset, tlv_len, "REG-RSP Encodings");
call_dissector(reg_rsp_handle, tvb_new_subset_length(tvb, tlv_offset, tlv_len), pinfo, sub_tree);
break;
/* Implemented message encoding 33 (Table 367 in IEEE 802.16e-2007) */
case RNG_RSP_DL_OP_BURST_PROFILE_OFDMA:
sub_item = add_tlv_subtree(&tlv_info, rng_rsp_tree, hf_rng_rsp_dl_op_burst_profile_ofdma, tvb, offset, ENC_BIG_ENDIAN);
sub_tree = proto_item_add_subtree(sub_item, ett_rng_rsp_message_tree);
proto_tree_add_item(sub_tree, hf_rng_rsp_least_robust_diuc, tvb, tlv_offset, 2, ENC_BIG_ENDIAN);
proto_tree_add_item(sub_tree, hf_rng_rsp_repetition_coding_indication, tvb, tlv_offset, 2, ENC_BIG_ENDIAN);
proto_tree_add_item(sub_tree, hf_rng_rsp_config_change_count_of_dcd, tvb, tlv_offset, 2, ENC_BIG_ENDIAN);
break;
case RNG_RSP_HO_ID:
add_tlv_subtree(&tlv_info, rng_rsp_tree, hf_rng_rsp_ho_id, tvb, offset, ENC_BIG_ENDIAN);
break;
case RNG_RSP_LOCATION_UPDATE_RESPONSE:
add_tlv_subtree(&tlv_info, rng_rsp_tree, hf_rng_rsp_location_update_response, tvb, offset, ENC_BIG_ENDIAN);
break;
case RNG_RSP_PAGING_INFORMATION:
sub_item = add_tlv_subtree(&tlv_info, rng_rsp_tree, hf_rng_rsp_paging_information, tvb, offset, ENC_NA);
sub_tree = proto_item_add_subtree(sub_item, ett_rng_rsp_message_tree);
proto_tree_add_item(sub_tree, hf_rng_rsp_paging_cycle, tvb, tlv_offset, 2, ENC_BIG_ENDIAN);
proto_tree_add_item(sub_tree, hf_rng_rsp_paging_offset, tvb, tlv_offset+2, 1, ENC_BIG_ENDIAN);
proto_tree_add_item(sub_tree, hf_rng_rsp_paging_group_id, tvb, tlv_offset+3, 2, ENC_BIG_ENDIAN);
break;
case RNG_RSP_POWER_SAVING_CLASS_PARAMETERS:
sub_tree = add_protocol_subtree(&tlv_info, ett_rng_rsp_message_tree, rng_rsp_tree, proto_mac_mgmt_msg_rng_rsp_decoder, tvb, offset, tlv_len, "Power Saving Class Parameters");
dissect_power_saving_class(sub_tree, tlv_type, tvb, tlv_len, pinfo, tlv_offset);
break;
case RNG_RSP_SA_CHALLENGE_TUPLE:
/* Display SA Challenge Tuple header */
sub_tree = add_protocol_subtree(&tlv_info, ett_rng_rsp_message_tree, rng_rsp_tree, proto_mac_mgmt_msg_rng_rsp_decoder, tvb, offset, tlv_len, "SA Challenge Tuple");
/* add subtree */
/* Use a local copy of tlv_offset */
this_offset = tlv_offset;
while(this_offset < tlv_len) {
/* Get the sub TLV data. */
init_tlv_info(&sub_tlv_info, tvb, this_offset);
/* get the sub TLV type */
sub_tlv_type = get_tlv_type(&sub_tlv_info);
/* get the TLV length */
sub_tlv_len = get_tlv_length(&sub_tlv_info);
if(tlv_type == -1 || sub_tlv_len > MAX_TLV_LEN || sub_tlv_len < 1)
{ /* invalid tlv info */
col_append_sep_str(pinfo->cinfo, COL_INFO, NULL, "RNG-RSP TLV error");
proto_tree_add_item(rng_rsp_tree, hf_rng_invalid_tlv, tvb, tlv_offset, (tvb_len - tlv_offset), ENC_NA);
break;
}
/* get the offset to the sub TLV data */
sub_tlv_offset = this_offset + get_tlv_value_offset(&sub_tlv_info);
switch (sub_tlv_type) {
case RNG_RSP_SA_CHALLENGE_BS_RANDOM:
add_tlv_subtree(&sub_tlv_info, sub_tree, hf_rng_rsp_bs_random, tvb, this_offset, ENC_NA);
break;
case RNG_RSP_SA_CHALLENGE_AKID:
add_tlv_subtree(&sub_tlv_info, sub_tree, hf_rng_rsp_akid, tvb, this_offset, ENC_NA);
break;
default:
add_tlv_subtree(&sub_tlv_info, sub_tree, hf_tlv_type, tvb, this_offset, ENC_NA);
break;
}
this_offset = sub_tlv_len + sub_tlv_offset;
}
break;
case DSx_UPLINK_FLOW:
/* display Uplink Service Flow Encodings info */
/* add subtree */
sub_tree = add_protocol_subtree(&tlv_info, ett_mac_mgmt_msg_rng_rsp_decoder, rng_rsp_tree, proto_mac_mgmt_msg_rng_rsp_decoder, tvb, offset, tlv_len, "Uplink QOS Parameters");
/* decode and display the DL Service Flow Encodings */
wimax_service_flow_encodings_decoder(tvb_new_subset_length(tvb, tlv_offset, tlv_len), pinfo, sub_tree);
break;
case DSx_DOWNLINK_FLOW:
/* display Downlink Service Flow Encodings info */
/* add subtree */
sub_tree = add_protocol_subtree(&tlv_info, ett_mac_mgmt_msg_rng_rsp_decoder, rng_rsp_tree, proto_mac_mgmt_msg_rng_rsp_decoder, tvb, offset, tlv_len, "Downlink QOS Parameters");
/* decode and display the DL Service Flow Encodings */
wimax_service_flow_encodings_decoder(tvb_new_subset_length(tvb, tlv_offset, tlv_len), pinfo, sub_tree);
break;
case RNG_RSP_RANGING_CODE_ATTRIBUTES:
/* case SHORT_HMAC_TUPLE: */
sub_item = add_tlv_subtree(&tlv_info, rng_rsp_tree, hf_rng_rsp_ranging_subchan, tvb, offset, ENC_BIG_ENDIAN);
sub_tree = proto_item_add_subtree(sub_item, ett_rng_rsp_message_tree);
proto_tree_add_item(sub_tree, hf_rng_rsp_time_symbol_reference, tvb, tlv_offset, 4, ENC_BIG_ENDIAN);
proto_tree_add_item(sub_tree, hf_rng_rsp_subchannel_reference, tvb, tlv_offset, 4, ENC_BIG_ENDIAN);
proto_tree_add_item(sub_tree, hf_rng_rsp_ranging_code_index, tvb, tlv_offset, 4, ENC_BIG_ENDIAN);
proto_tree_add_item(sub_tree, hf_rng_rsp_frame_number2, tvb, tlv_offset, 4, ENC_BIG_ENDIAN);
break;
case SHORT_HMAC_TUPLE_COR2:
if (include_cor2_changes) {
sub_tree = add_protocol_subtree(&tlv_info, ett_rng_rsp_message_tree, rng_rsp_tree, proto_mac_mgmt_msg_rng_rsp_decoder, tvb, offset, tlv_len, "Short HMAC Tuple");
wimax_short_hmac_tuple_decoder(sub_tree, tvb, tlv_offset, tvb_len - offset);
} else {
/* Unknown TLV type */
add_tlv_subtree(&tlv_info, rng_rsp_tree, hf_tlv_type, tvb, offset, ENC_NA);
}
break;
default:
add_tlv_subtree(&tlv_info, rng_rsp_tree, hf_tlv_type, tvb, offset, ENC_NA);
break;
}
offset = tlv_len + tlv_offset;
} /* end of TLV process while loop */
/*
* XXX - these should probably be expert info items.
*/
if (ranging_status_item && dl_freq_override_item)
proto_item_append_text(ranging_status_item, " (shall be set to 2 because Downlink Frequency Override is present)");
if (ss_mac_address_item && frame_number_item) {
proto_item_append_text(frame_number_item, " (mutually exclusive with SS MAC Address!)");
proto_item_append_text(ss_mac_address_item, " (mutually exclusive with Frame Number!)");
}
if (ss_mac_address_item && opportunity_number_item) {
proto_item_append_text(opportunity_number_item, " (mutually exclusive with SS MAC Address!)");
proto_item_append_text(ss_mac_address_item, " (mutually exclusive with Initial Ranging Opportunity Number!)");
}
if (!ranging_status_item)
proto_item_append_text(rng_rsp_tree, " (Ranging status is missing!)");
}
return tvb_captured_length(tvb);
}
/* Register Wimax Mac Payload Protocol and Dissector */
void proto_register_mac_mgmt_msg_rng_rsp(void)
{
/* RNG-RSP fields display */
static hf_register_info hf[] =
{
{
&hf_rng_rsp_broadcast,
{
"AAS broadcast permission", "wmx.rng_rsp.aas_broadcast",
FT_BOOLEAN, BASE_NONE, TFS(&tfs_rng_rsp_aas_broadcast), 0x0, NULL, HFILL
}
},
{
&hf_rng_rsp_akid,
{
"AKId", "wmx.rng_rsp.akid",
FT_BYTES, BASE_NONE, NULL, 0x00, NULL, HFILL
}
},
{
&hf_rng_rsp_basic_cid,
{
"Basic CID", "wmx.rng_rsp.basic_cid",
FT_UINT16, BASE_DEC, NULL, 0x00, NULL, HFILL
}
},
{
&hf_rng_rsp_bs_random,
{
"BS_Random", "wmx.rng_rsp.bs_random",
FT_BYTES, BASE_NONE, NULL, 0x00, NULL, HFILL
}
},
{
&hf_rng_rsp_config_change_count_of_dcd,
{
"Configuration Change Count value of DCD defining DIUC associated burst profile", "wmx.rng_rsp.config_change_count_of_dcd",
FT_UINT16, BASE_HEX, NULL, 0xFF00, NULL, HFILL
}
},
{
&hf_rng_rsp_dl_freq_override,
{
"Downlink Frequency Override", "wmx.rng_rsp.dl_freq_override",
FT_UINT32, BASE_DEC|BASE_UNIT_STRING, &wimax_units_hz, 0x00, NULL, HFILL
}
},
{
&hf_rng_rsp_dl_operational_burst_profile_ccc,
{
"CCC value of DCD defining the burst profile associated with DIUC", "wmx.rng_rsp.dl_op_burst_prof.ccc",
FT_UINT16, BASE_DEC, NULL, 0x00FF, NULL, HFILL
}
},
{
&hf_rng_rsp_dl_operational_burst_profile_diuc,
{
"The least robust DIUC that may be used by the BS for transmissions to the SS", "wmx.rng_rsp.dl_op_burst_prof.diuc",
FT_UINT16, BASE_DEC, NULL, 0xFF00, NULL, HFILL
}
},
{
&hf_rng_rsp_dl_operational_burst_profile,
{
"Downlink Operational Burst Profile", "wmx.rng_rsp.dl_op_burst_profile",
FT_UINT16, BASE_HEX, NULL, 0x00, NULL, HFILL
}
},
/* Added the following to help implement RNG-RSP message encoding 33 (Table 367 in IEEE 802.16e-2007) */
{
&hf_rng_rsp_dl_op_burst_profile_ofdma,
{
"Downlink Operational Burst Profile for OFDMA", "wmx.rng_rsp.dl_op_burst_profile_ofdma",
FT_UINT16, BASE_HEX, NULL, 0x00, NULL, HFILL
}
},
{
&hf_rng_rsp_frame_number2,
{
"The 8 least significant bits of the frame number of the OFDMA frame where the SS sent the ranging code", "wmx.rng_rsp.eight_bit_frame_num",
FT_UINT32, BASE_DEC, NULL, 0x000000FF, NULL, HFILL
}
},
{
&hf_rng_rsp_frame_number,
{
"Frame number", "wmx.rng_rsp.frame_number",
FT_UINT24, BASE_DEC, NULL, 0x00, NULL, HFILL
}
},
/* Added the following to help implement RNG-RSP message encoding 22 (IEEE 802.16e-2007) */
{
&hf_rng_rsp_ho_id,
{
"HO ID", "wmx.rng_rsp.ho_id",
FT_UINT8, BASE_HEX, NULL, 0x00, NULL, HFILL
}
},
{
&hf_rng_rsp_ho_process_optimization,
{
"HO Process Optimization", "wmx.rng_rsp.ho_process_optimization",
FT_UINT16, BASE_HEX, NULL, 0x0000, NULL, HFILL
}
},
{
&hf_rng_rsp_ho_process_optimization_0,
{
"Bit #0", "wmx.rng_rsp.ho_process_optimization.omit_sbc_req",
FT_UINT16, BASE_HEX, VALS(vals_rng_rsp_ho_process_optimization_0), 0x0001, NULL, HFILL
}
},
{
&hf_rng_rsp_ho_process_optimization_1_2,
{
"Bits #1-2", "wmx.rng_rsp.ho_process_optimization.perform_reauthentication",
FT_UINT16, BASE_HEX, VALS(vals_rng_rsp_ho_process_optimization_1_2), 0x0006, NULL, HFILL
}
},
{
&hf_rng_rsp_ho_process_optimization_3,
{
"Bit #3", "wmx.rng_rsp.ho_process_optimization.omit_network_address",
FT_UINT16, BASE_HEX, VALS(vals_rng_rsp_ho_process_optimization_3), 0x0008, NULL, HFILL
}
},
{
&hf_rng_rsp_ho_process_optimization_4,
{
"Bit #4", "wmx.rng_rsp.ho_process_optimization.omit_time_of_day",
FT_UINT16, BASE_HEX, VALS(vals_rng_rsp_ho_process_optimization_4), 0x0010, NULL, HFILL
}
},
{
&hf_rng_rsp_ho_process_optimization_5,
{
"Bit #5", "wmx.rng_rsp.ho_process_optimization.omit_tftp",
FT_UINT16, BASE_HEX, VALS(vals_rng_rsp_ho_process_optimization_5), 0x0020, NULL, HFILL
}
},
{
&hf_rng_rsp_ho_process_optimization_6,
{
"Bit #6", "wmx.rng_rsp.ho_process_optimization.transfer_or_sharing",
FT_UINT16, BASE_HEX, VALS(vals_rng_rsp_ho_process_optimization_6), 0x0040, NULL, HFILL
}
},
{
&hf_rng_rsp_ho_process_optimization_7,
{
"Bit #7", "wmx.rng_rsp.ho_process_optimization.omit_reg_req",
FT_UINT16, BASE_HEX, VALS(vals_rng_rsp_ho_process_optimization_7), 0x0080, NULL, HFILL
}
},
{
&hf_rng_rsp_ho_process_optimization_8,
{
"Bit #8", "wmx.rng_rsp.ho_process_optimization.unsolicited_sbc_rsp",
FT_UINT16, BASE_HEX, VALS(vals_rng_rsp_ho_process_optimization_8), 0x0100, NULL, HFILL
}
},
{
&hf_rng_rsp_ho_process_optimization_9,
{
"Bit #9", "wmx.rng_rsp.ho_process_optimization.post_ho_reentry",
FT_UINT16, BASE_HEX, VALS(vals_rng_rsp_ho_process_optimization_9), 0x0200, NULL, HFILL
}
},
{
&hf_rng_rsp_ho_process_optimization_10,
{
"Bit #10", "wmx.rng_rsp.ho_process_optimization.unsolicited_reg_rsp",
FT_UINT16, BASE_HEX, VALS(vals_rng_rsp_ho_process_optimization_10), 0x0400, NULL, HFILL
}
},
{
&hf_rng_rsp_ho_process_optimization_11,
{
"Bit #11", "wmx.rng_rsp.ho_process_optimization.virtual_sdu_sn",
FT_UINT16, BASE_HEX, VALS(vals_rng_rsp_ho_process_optimization_11), 0x0800, NULL, HFILL
}
},
{
&hf_rng_rsp_ho_process_optimization_12,
{
"Bit #12", "wmx.rng_rsp.ho_process_optimization.send_notification",
FT_UINT16, BASE_HEX, VALS(vals_rng_rsp_ho_process_optimization_12), 0x1000, NULL, HFILL
}
},
{
&hf_rng_rsp_ho_process_optimization_13,
{
"Bit #13", "wmx.rng_rsp.ho_process_optimization.trigger_higher_layer_protocol",
FT_UINT16, BASE_HEX, VALS(vals_rng_rsp_ho_process_optimization_13), 0x2000, NULL, HFILL
}
},
{
&hf_rng_rsp_ho_process_optimization_14,
{
"Bit #14: Reserved", "wmx.rng_rsp.ho_process_optimization.reserved",
FT_UINT16, BASE_HEX, NULL, 0x4000, NULL, HFILL
}
},
{
&hf_rng_rsp_ho_process_optimization_15,
{
"Bit #15: Reserved", "wmx.rng_rsp.ho_process_optimization.reserved",
FT_UINT16, BASE_HEX, NULL, 0x8000, NULL, HFILL
}
},
{
&hf_rng_invalid_tlv,
{
"Invalid TLV", "wmx.rng_rsp.invalid_tlv",
FT_BYTES, BASE_NONE, NULL, 0, NULL, HFILL
}
},
{
&hf_rng_rsp_least_robust_diuc,
{
"Least Robust DIUC that may be used by the BS for transmissions to the MS", "wmx.rng_rsp.least_robust_diuc",
FT_UINT16, BASE_HEX, NULL, 0x000F, NULL, HFILL
}
},
{
&hf_rng_rsp_location_update_response,
{
"Location Update Response", "wmx.rng_rsp.location_update_response",
FT_UINT8, BASE_DEC, VALS(vals_rng_rsp_location_update_response), 0xFF, NULL, HFILL
}
},
{
&hf_rng_rsp_offset_freq_adjust,
{
"Offset Frequency Adjust", "wmx.rng_rsp.offset_freq_adjust",
FT_INT32, BASE_DEC|BASE_UNIT_STRING, &wimax_units_hz, 0x00, NULL, HFILL
}
},
{
&hf_rng_rsp_opportunity_number,
{
"Initial ranging opportunity number", "wmx.rng_rsp.opportunity_number",
FT_UINT8, BASE_DEC, NULL, 0x00, NULL, HFILL
}
},
{
&hf_rng_rsp_paging_cycle,
{
"Paging Cycle", "wmx.rng_rsp.paging_cycle",
FT_UINT16, BASE_DEC, NULL, 0x00, NULL, HFILL
}
},
{
&hf_rng_rsp_paging_group_id,
{
"Paging Group ID", "wmx.rng_rsp.paging_group_id",
FT_UINT16, BASE_DEC, NULL, 0x00, NULL, HFILL
}
},
{
&hf_rng_rsp_paging_information,
{
"Paging Information", "wmx.rng_rsp.paging_information",
FT_BYTES, BASE_NONE, NULL, 0x00, NULL, HFILL
}
},
{
&hf_rng_rsp_paging_offset,
{
"Paging Offset", "wmx.rng_rsp.paging_offset",
FT_UINT8, BASE_DEC, NULL, 0x00, NULL, HFILL
}
},
{
&hf_rng_rsp_power_level_adjust,
{
"Power Level Adjust", "wmx.rng_rsp.power_level_adjust",
FT_FLOAT, BASE_NONE, NULL, 0x00, NULL, HFILL
}
},
{
&hf_rng_rsp_primary_mgmt_cid,
{
"Primary Management CID", "wmx.rng_rsp.primary_mgmt_cid",
FT_UINT16, BASE_DEC, NULL, 0x00, NULL, HFILL
}
},
{
&hf_rng_rsp_ranging_code_index,
{
"The ranging code index that was sent by the SS", "wmx.rng_rsp.ranging_code_index",
FT_UINT32, BASE_DEC, NULL, 0x0000FF00, NULL, HFILL
}
},
{
&hf_rng_rsp_ranging_status,
{
"Ranging status", "wmx.rng_rsp.ranging_status",
FT_UINT8, BASE_DEC, VALS(vals_rng_rsp_ranging_status), 0x00, NULL, HFILL
}
},
{
&hf_rng_rsp_ranging_subchan,
{
"Ranging code attributes", "wmx.rng_rsp.ranging_subchannel",
FT_UINT32, BASE_HEX, NULL, 0x00, NULL, HFILL
}
},
{
&hf_rng_rsp_repetition_coding_indication,
{
"Repetition Coding Indication", "wmx.rng_rsp.repetition_coding_indication",
FT_UINT16, BASE_HEX, VALS(vals_rng_rsp_repetition_coding_indication), 0x00F0, NULL, HFILL
}
},
{
&hf_rng_req_reserved,
{
"Reserved", "wmx.rng_rsp.reserved",
FT_UINT8, BASE_DEC, NULL, 0x0, NULL, HFILL
}
},
{
&hf_rng_rsp_resource_retain_flag,
{
"The connection information for the MS is", "wmx.rng_rsp.resource_retain_flag",
FT_BOOLEAN, BASE_NONE, TFS(&tfs_rng_rsp_resource_retain_flag), 0x0, NULL, HFILL
}
},
{
&hf_rng_rsp_service_level_prediction,
{
"Service Level Prediction", "wmx.rng_rsp.service_level_prediction",
FT_UINT8, BASE_DEC, VALS(vals_rng_rsp_level_of_service), 0x00, NULL, HFILL
}
},
{
&hf_rng_rsp_ss_mac_address,
{
"SS MAC Address", "wmx.rng_rsp.ss_mac_address",
FT_ETHER, BASE_NONE, NULL, 0x00, NULL, HFILL
}
},
{
&hf_rng_rsp_subchannel_reference,
{
"OFDMA subchannel reference used to transmit the ranging code", "wmx.rng_rsp.subchannel_reference",
FT_UINT32, BASE_DEC, NULL, 0x003f0000, NULL, HFILL
}
},
{
&hf_rng_rsp_time_symbol_reference,
{
"OFDM time symbol reference used to transmit the ranging code", "wmx.rng_rsp.time_symbol_reference",
FT_UINT32, BASE_DEC, NULL, 0xFFC00000, NULL, HFILL
}
},
{
&hf_rng_rsp_timing_adjust,
{
"Timing Adjust", "wmx.rng_rsp.timing_adjust",
FT_FLOAT, BASE_NONE, NULL, 0x00, NULL, HFILL
}
},
#if 0
{
&hf_rng_rsp_ul_channel_id,
{
"Uplink Channel ID", "wmx.rng_rsp.ul_chan_id",
FT_UINT8, BASE_DEC, NULL, 0x00, NULL, HFILL
}
},
#endif
{
&hf_rng_rsp_ul_chan_id_override,
{
"Uplink channel ID Override", "wmx.rng_rsp.ul_chan_id_override",
FT_UINT8, BASE_DEC, NULL, 0x00, NULL, HFILL
}
},
{
&hf_tlv_type,
{
"Unknown TLV Type", "wmx.rng_rsp.unknown_tlv_type",
FT_BYTES, BASE_NONE, NULL, 0x00, NULL, HFILL
}
},
#if 0
{
&hf_tlv_value,
{
"Value", "wmx.rng_rsp.tlv_value",
FT_BYTES, BASE_NONE, NULL, 0x00, NULL, HFILL
}
}
#endif
};
/* Setup protocol subtree array */
static gint *ett[] =
{
&ett_mac_mgmt_msg_rng_rsp_decoder,
&ett_rng_rsp_message_tree
};
proto_mac_mgmt_msg_rng_rsp_decoder = proto_register_protocol (
"WiMax RNG-RSP Messages", /* name */
"WiMax RNG-RSP", /* short name */
"wmx.rng_rsp" /* abbrev */
);
proto_register_field_array(proto_mac_mgmt_msg_rng_rsp_decoder, hf, array_length(hf));
proto_register_subtree_array(ett, array_length(ett));
}
void proto_reg_handoff_mac_mgmt_msg_rng_rsp(void)
{
dissector_handle_t rng_rsp_handle;
rng_rsp_handle = create_dissector_handle(dissect_mac_mgmt_msg_rng_rsp_decoder, proto_mac_mgmt_msg_rng_rsp_decoder);
dissector_add_uint("wmx.mgmtmsg", MAC_MGMT_MSG_RNG_RSP, rng_rsp_handle);
sbc_rsp_handle = find_dissector("mac_mgmt_msg_sbc_rsp_handler");
reg_rsp_handle = find_dissector("mac_mgmt_msg_reg_rsp_handler");
}
/*
* Editor modelines - https://www.wireshark.org/tools/modelines.html
*
* Local variables:
* c-basic-offset: 8
* tab-width: 8
* indent-tabs-mode: t
* End:
*
* vi: set shiftwidth=8 tabstop=8 noexpandtab:
* :indentSize=8:tabSize=8:noTabs=false:
*/