/* * 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 "6LoWPAN/ws/ws_config.h" #include "6LoWPAN/ws/ws_common_defines.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) { (void)regulatory_domain; for (uint8_t i = 0; i < number_of_channels; i++) { channel_mask[0 + (i / 32)] |= (1 << (i % 32)); } return 0; } static 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; } static 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; } static 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; } } static int ws_set_domain_rf_config(protocol_interface_info_entry_t *cur) { phy_rf_channel_configuration_s rf_configs; rf_configs.channel_0_center_frequency = (uint32_t)cur->ws_info->hopping_schdule.ch0_freq * 100000; rf_configs.channel_spacing = ws_decode_channel_spacing(cur->ws_info->hopping_schdule.channel_spacing); rf_configs.datarate = ws_get_datarate_using_operating_mode(cur->ws_info->hopping_schdule.operating_mode); rf_configs.modulation_index = ws_get_modulation_index_using_operating_mode(cur->ws_info->hopping_schdule.operating_mode); rf_configs.modulation = M_2FSK; rf_configs.number_of_channels = cur->ws_info->hopping_schdule.number_of_channels; ws_bootstrap_set_rf_config(cur, rf_configs); return 0; } int8_t ws_common_regulatory_domain_config(protocol_interface_info_entry_t *cur, ws_hopping_schedule_t *hopping_schdule) { 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_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; } if (cur) { ws_set_domain_rf_config(cur); } 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_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.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); } 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 = 8000; } else if (network_size <= NETWORK_SIZE_MEDIUM) { latency = 16000; } else { latency = 32000; } 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 = 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) { // tens of devices (now 30), handles also NETWORK_SIZE_CERTIFICATE network_size_estimate = 30; } else if (network_size <= NETWORK_SIZE_MEDIUM) { // hundreds of devices (now 300) network_size_estimate = 300; } else { // huge amount of devices (now 1000) network_size_estimate = 1000; } return network_size_estimate; } #endif // HAVE_WS