/* * Copyright (c) 2018-2019, Arm Limited and affiliates. * SPDX-License-Identifier: Apache-2.0 * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include "nsconfig.h" #include "ns_types.h" #include "ns_trace.h" #include "randLIB.h" #include #include #include "Common_Protocols/icmpv6.h" #include "mac_common_defines.h" #include "net_interface.h" #include "6LoWPAN/MAC/mpx_api.h" #include "6LoWPAN/ws/ws_config.h" #include "6LoWPAN/ws/ws_common_defines.h" #include "6LoWPAN/ws/ws_llc.h" #include "6LoWPAN/ws/ws_common.h" #include "6LoWPAN/ws/ws_bootstrap.h" #include "6LoWPAN/ws/ws_bbr_api_internal.h" #include "6LoWPAN/ws/ws_pae_controller.h" #include "6LoWPAN/ws/ws_cfg_settings.h" #include "Service_Libs/etx/etx.h" #include "Service_Libs/mac_neighbor_table/mac_neighbor_table.h" #include "Service_Libs/blacklist/blacklist.h" #include "RPL/rpl_protocol.h" #include "RPL/rpl_control.h" #include "ws_management_api.h" #include "mac_api.h" #ifdef HAVE_WS #define TRACE_GROUP "wscm" // estimated sensitivity -93 dbm converted to Wi-SUN RSL range // This provides a range of -174 (0) to +80 (254) dBm uint8_t DEVICE_MIN_SENS = 174 - 93; uint16_t test_max_child_count_override = 0xffff; int8_t ws_generate_channel_list(uint32_t *channel_mask, uint16_t number_of_channels, uint8_t regulatory_domain, uint8_t operating_class) { uint32_t excluded_start_channel = 0xFFFFFFFF; uint32_t excluded_end_channel = 0xFFFFFFFF; if (regulatory_domain == REG_DOMAIN_BZ) { if (operating_class == 1) { excluded_start_channel = 26; excluded_end_channel = 64; } else if (operating_class == 2) { excluded_start_channel = 12; excluded_end_channel = 32; } else if (operating_class == 3) { excluded_start_channel = 7; excluded_end_channel = 21; } } // Clear channel mask for (uint8_t i = 0; i < 8; i++) { channel_mask[i] = 0; } // Set channel maks outside excluded channels for (uint16_t i = 0; i < number_of_channels; i++) { if (i < excluded_start_channel || i > excluded_end_channel) { channel_mask[0 + (i / 32)] |= (1 << (i % 32)); } } return 0; } uint16_t ws_active_channel_count(uint32_t *channel_mask, uint16_t number_of_channels) { uint16_t active_channels = 0; // Set channel maks outside excluded channels for (uint16_t i = 0; i < number_of_channels; i++) { if (channel_mask[0 + (i / 32)] & (1 << (i % 32))) { active_channels++; } } return active_channels; } uint32_t ws_decode_channel_spacing(uint8_t channel_spacing) { if (CHANNEL_SPACING_100 == channel_spacing) { return 100000; } else if (CHANNEL_SPACING_200 == channel_spacing) { return 200000; } else if (CHANNEL_SPACING_250 == channel_spacing) { return 250000; } else if (CHANNEL_SPACING_400 == channel_spacing) { return 400000; } else if (CHANNEL_SPACING_600 == channel_spacing) { return 600000; } return 0; } uint32_t ws_get_datarate_using_operating_mode(uint8_t operating_mode) { if ((OPERATING_MODE_1a == operating_mode) || (OPERATING_MODE_1b == operating_mode)) { return 50000; } else if ((OPERATING_MODE_2a == operating_mode) || (OPERATING_MODE_2b == operating_mode)) { return 100000; } else if (OPERATING_MODE_3 == operating_mode) { return 150000; } else if ((OPERATING_MODE_4a == operating_mode) || (OPERATING_MODE_4b == operating_mode)) { return 200000; } else if (OPERATING_MODE_5 == operating_mode) { return 300000; } return 0; } phy_modulation_index_e ws_get_modulation_index_using_operating_mode(uint8_t operating_mode) { if ((OPERATING_MODE_1b == operating_mode) || (OPERATING_MODE_2b == operating_mode) || (OPERATING_MODE_4b == operating_mode)) { return MODULATION_INDEX_1_0; } else { return MODULATION_INDEX_0_5; } } int8_t ws_common_regulatory_domain_config(protocol_interface_info_entry_t *cur, ws_hopping_schedule_t *hopping_schdule) { (void)cur; if (ws_get_datarate_using_operating_mode(hopping_schdule->operating_mode) == 0) { //Unsupported operation mode return -1; } hopping_schdule->channel_plan = 0; if (hopping_schdule->regulatory_domain == REG_DOMAIN_KR) { if (hopping_schdule->operating_class == 1) { hopping_schdule->ch0_freq = 9171; hopping_schdule->channel_spacing = CHANNEL_SPACING_200; } else if (hopping_schdule->operating_class == 2) { hopping_schdule->ch0_freq = 9173; hopping_schdule->channel_spacing = CHANNEL_SPACING_400; } else { return -1; } } else if (hopping_schdule->regulatory_domain == REG_DOMAIN_EU) { if (hopping_schdule->operating_class == 1) { hopping_schdule->ch0_freq = 8631; hopping_schdule->channel_spacing = CHANNEL_SPACING_100; } else if (hopping_schdule->operating_class == 2) { hopping_schdule->ch0_freq = 8631; hopping_schdule->channel_spacing = CHANNEL_SPACING_200; } else if (hopping_schdule->operating_class == 3) { hopping_schdule->ch0_freq = 8701; hopping_schdule->channel_spacing = CHANNEL_SPACING_100; } else if (hopping_schdule->operating_class == 4) { hopping_schdule->ch0_freq = 8702; hopping_schdule->channel_spacing = CHANNEL_SPACING_200; } else { return -1; } } else if (hopping_schdule->regulatory_domain == REG_DOMAIN_IN) { if (hopping_schdule->operating_class == 1) { hopping_schdule->ch0_freq = 8651; hopping_schdule->channel_spacing = CHANNEL_SPACING_100; } else if (hopping_schdule->operating_class == 2) { hopping_schdule->ch0_freq = 8651; hopping_schdule->channel_spacing = CHANNEL_SPACING_200; } else { return -1; } } else if (hopping_schdule->regulatory_domain == REG_DOMAIN_NA) { if (hopping_schdule->operating_class == 1) { hopping_schdule->ch0_freq = 9022; hopping_schdule->channel_spacing = CHANNEL_SPACING_200; } else if (hopping_schdule->operating_class == 2) { hopping_schdule->ch0_freq = 9024; hopping_schdule->channel_spacing = CHANNEL_SPACING_400; } else if (hopping_schdule->operating_class == 3) { hopping_schdule->ch0_freq = 9026; hopping_schdule->channel_spacing = CHANNEL_SPACING_600; } else { return -1; } } else if (hopping_schdule->regulatory_domain == REG_DOMAIN_BZ) { if (hopping_schdule->operating_class == 1) { hopping_schdule->ch0_freq = 9022; hopping_schdule->channel_spacing = CHANNEL_SPACING_200; } else if (hopping_schdule->operating_class == 2) { hopping_schdule->ch0_freq = 9024; hopping_schdule->channel_spacing = CHANNEL_SPACING_400; } else if (hopping_schdule->operating_class == 3) { hopping_schdule->ch0_freq = 9026; hopping_schdule->channel_spacing = CHANNEL_SPACING_600; } else { return -1; } } else if (hopping_schdule->regulatory_domain == REG_DOMAIN_JP) { if (hopping_schdule->operating_class == 1) { hopping_schdule->ch0_freq = 9206; hopping_schdule->channel_spacing = CHANNEL_SPACING_200; } else if (hopping_schdule->operating_class == 2) { hopping_schdule->ch0_freq = 9209; hopping_schdule->channel_spacing = CHANNEL_SPACING_400; } else if (hopping_schdule->operating_class == 3) { hopping_schdule->ch0_freq = 9208; hopping_schdule->channel_spacing = CHANNEL_SPACING_600; } else { return -1; } } else if (hopping_schdule->regulatory_domain == REG_DOMAIN_WW) { if (hopping_schdule->operating_class == 1) { hopping_schdule->ch0_freq = 24002; hopping_schdule->channel_spacing = CHANNEL_SPACING_200; } else if (hopping_schdule->operating_class == 2) { hopping_schdule->ch0_freq = 24004; hopping_schdule->channel_spacing = CHANNEL_SPACING_400; } else { return -1; } } else { return -1; } hopping_schdule->number_of_channels = (uint8_t)ws_common_channel_number_calc(hopping_schdule->regulatory_domain, hopping_schdule->operating_class); if (!hopping_schdule->number_of_channels) { return -1; } return 0; } uint16_t ws_common_channel_number_calc(uint8_t regulatory_domain, uint8_t operating_class) { if (regulatory_domain == REG_DOMAIN_KR) { if (operating_class == 1) { return 32; } else if (operating_class == 2) { return 16; } } else if (regulatory_domain == REG_DOMAIN_EU) { if (operating_class == 1) { return 69; } else if (operating_class == 2) { return 35; } else if (operating_class == 3) { return 55; } else if (operating_class == 4) { return 27; } } else if (regulatory_domain == REG_DOMAIN_IN) { if (operating_class == 1) { return 19; } else if (operating_class == 2) { return 10; } } else if (regulatory_domain == REG_DOMAIN_NA) { if (operating_class == 1) { return 129; } else if (operating_class == 2) { return 64; } else if (operating_class == 3) { return 42; } } else if (regulatory_domain == REG_DOMAIN_JP) { if (operating_class == 1) { return 38; } else if (operating_class == 2) { return 18; } else if (operating_class == 3) { return 12; } } else if (regulatory_domain == REG_DOMAIN_BZ) { if (operating_class == 1) { return 129; } else if (operating_class == 2) { return 64; } else if (operating_class == 3) { return 42; } } else if (regulatory_domain == REG_DOMAIN_WW) { if (operating_class == 1) { // TODO we dont support this yet, but it is used as test value return 416; } else if (operating_class == 2) { return 207; } } return 0; } int8_t ws_common_allocate_and_init(protocol_interface_info_entry_t *cur) { if (!cur->ws_info) { cur->ws_info = ns_dyn_mem_alloc(sizeof(ws_info_t)); } if (!cur->ws_info) { return -1; } memset(cur->ws_info, 0, sizeof(ws_info_t)); ns_list_init(&cur->ws_info->active_nud_process); ns_list_init(&cur->ws_info->free_nud_entries); ns_list_init(&cur->ws_info->parent_list_free); ns_list_init(&cur->ws_info->parent_list_reserved); cur->ws_info->network_pan_id = 0xffff; cur->ws_info->pan_information.use_parent_bs = true; cur->ws_info->pan_information.rpl_routing_method = true; cur->ws_info->pan_information.pan_version_set = false; cur->ws_info->pan_information.version = WS_FAN_VERSION_1_0; cur->ws_info->pending_key_index_info.state = NO_PENDING_PROCESS; cur->ws_info->hopping_schdule.regulatory_domain = REG_DOMAIN_EU; cur->ws_info->hopping_schdule.operating_mode = OPERATING_MODE_3; cur->ws_info->hopping_schdule.operating_class = 2; // Clock drift value 255 indicates that information is not provided cur->ws_info->hopping_schdule.clock_drift = 255; // Timing accuracy is given from 0 to 2.55msec with 10usec resolution cur->ws_info->hopping_schdule.timing_accurancy = 100; ws_common_regulatory_domain_config(cur, &cur->ws_info->hopping_schdule); cur->ws_info->pending_key_index_info.state = NO_PENDING_PROCESS; return 0; } void ws_common_seconds_timer(protocol_interface_info_entry_t *cur, uint32_t seconds) { ws_bbr_seconds_timer(cur, seconds); ws_bootstrap_seconds_timer(cur, seconds); blacklist_ttl_update(seconds); } void ws_common_fast_timer(protocol_interface_info_entry_t *cur, uint16_t ticks) { ws_bootstrap_trickle_timer(cur, ticks); ws_nud_active_timer(cur, ticks); ws_llc_fast_timer(cur, ticks); } void ws_common_neighbor_update(protocol_interface_info_entry_t *cur, const uint8_t *ll_address) { //Neighbor connectected update mac_neighbor_table_entry_t *mac_neighbor = mac_neighbor_entry_get_by_ll64(mac_neighbor_info(cur), ll_address, false, NULL); if (mac_neighbor) { ws_nud_entry_remove_active(cur, mac_neighbor); } } void ws_common_aro_failure(protocol_interface_info_entry_t *cur, const uint8_t *ll_address) { tr_warn("ARO registration Failure %s", trace_ipv6(ll_address)); blacklist_update(ll_address, false); ws_bootstrap_aro_failure(cur, ll_address); } void ws_common_neighbor_remove(protocol_interface_info_entry_t *cur, const uint8_t *ll_address) { tr_debug("neighbor remove %s", trace_ipv6(ll_address)); ws_bootstrap_neighbor_remove(cur, ll_address); } uint8_t ws_common_allow_child_registration(protocol_interface_info_entry_t *interface, const uint8_t *eui64) { uint8_t child_count = 0; uint8_t max_child_count = mac_neighbor_info(interface)->list_total_size - WS_NON_CHILD_NEIGHBOUR_COUNT; // Test API to limit child count if (test_max_child_count_override != 0xffff) { max_child_count = test_max_child_count_override; } //Validate Is EUI64 already allocated for any address if (ipv6_neighbour_has_registered_by_eui64(&interface->ipv6_neighbour_cache, eui64)) { /* * ARO registration from child can update the link timeout so we don't need to send extra NUD if ARO received */ mac_neighbor_table_entry_t *mac_neighbor = mac_neighbor_entry_get_by_mac64(mac_neighbor_info(interface), eui64, false, false); if (mac_neighbor) { mac_neighbor_table_neighbor_refresh(mac_neighbor_info(interface), mac_neighbor, mac_neighbor->link_lifetime); } tr_info("Child registration from old child"); return ARO_SUCCESS; } //Verify that we have Selected Parent if (interface->bootsrap_mode != ARM_NWK_BOOTSRAP_MODE_6LoWPAN_BORDER_ROUTER && !rpl_control_parent_candidate_list_size(interface, true)) { tr_info("Do not accept new ARO child: no selected parent"); return ARO_TOPOLOGICALLY_INCORRECT; } ns_list_foreach_safe(mac_neighbor_table_entry_t, cur, &mac_neighbor_info(interface)->neighbour_list) { if (ipv6_neighbour_has_registered_by_eui64(&interface->ipv6_neighbour_cache, cur->mac64)) { child_count++; } } if (child_count >= max_child_count) { tr_warn("Child registration not allowed %d/%d, max:%d", child_count, max_child_count, mac_neighbor_info(interface)->list_total_size); return ARO_FULL; } tr_info("Child registration allowed %d/%d, max:%d", child_count, max_child_count, mac_neighbor_info(interface)->list_total_size); return ARO_SUCCESS; } bool ws_common_negative_aro_mark(protocol_interface_info_entry_t *interface, const uint8_t *eui64) { mac_neighbor_table_entry_t *neighbour = mac_neighbor_table_address_discover(mac_neighbor_info(interface), eui64, ADDR_802_15_4_LONG); if (!neighbour) { return false; } ws_neighbor_class_entry_t *ws_neighbor = ws_neighbor_class_entry_get(&interface->ws_info->neighbor_storage, neighbour->index); ws_neighbor->negative_aro_send = true; neighbour->lifetime = WS_NEIGHBOR_TEMPORARY_LINK_MIN_TIMEOUT_SMALL; //Remove anyway if Packet is freed before MAC push return true; } uint32_t ws_common_latency_estimate_get(protocol_interface_info_entry_t *cur) { uint32_t latency = 0; uint8_t network_size = cur->ws_info->cfg->gen.network_size; if (network_size == NETWORK_SIZE_AUTOMATIC) { network_size = cur->ws_info->pan_information.pan_size / 100; } if (network_size <= NETWORK_SIZE_SMALL) { // handles also NETWORK_SIZE_CERTIFICATE latency = 4000; } else if (network_size <= NETWORK_SIZE_MEDIUM) { latency = 8000; } else if (network_size <= NETWORK_SIZE_LARGE) { latency = 16000; } else { latency = 24000; } return latency; } uint32_t ws_common_datarate_get(protocol_interface_info_entry_t *cur) { return ws_get_datarate_using_operating_mode(cur->ws_info->hopping_schdule.operating_mode); } uint32_t ws_common_network_size_estimate_get(protocol_interface_info_entry_t *cur) { uint32_t network_size_estimate = 100; if ((cur->ws_info->cfg->gen.network_size != NETWORK_SIZE_AUTOMATIC) && (cur->ws_info->cfg->gen.network_size != NETWORK_SIZE_CERTIFICATE)) { network_size_estimate = cur->ws_info->cfg->gen.network_size * 100; } return network_size_estimate; } void ws_common_primary_parent_update(protocol_interface_info_entry_t *interface, mac_neighbor_table_entry_t *neighbor) { ws_bootstrap_primary_parent_update(interface, neighbor); } void ws_common_secondary_parent_update(protocol_interface_info_entry_t *interface) { ws_bootstrap_secondary_parent_update(interface); } #endif // HAVE_WS