diff options
Diffstat (limited to 'plugins/epan/wimax/msg_rng_rsp.c')
| -rw-r--r-- | plugins/epan/wimax/msg_rng_rsp.c | 975 |
1 files changed, 975 insertions, 0 deletions
diff --git a/plugins/epan/wimax/msg_rng_rsp.c b/plugins/epan/wimax/msg_rng_rsp.c new file mode 100644 index 0000000000..ea85a2b9cd --- /dev/null +++ b/plugins/epan/wimax/msg_rng_rsp.c @@ -0,0 +1,975 @@ +/* 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 + * + * 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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. + */ + +/* 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 - http://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: + */ |