| /* |
| * Copyright (c) 2020, The OpenThread Authors. |
| * All rights reserved. |
| * |
| * Redistribution and use in source and binary forms, with or without |
| * modification, are permitted provided that the following conditions are met: |
| * 1. Redistributions of source code must retain the above copyright |
| * notice, this list of conditions and the following disclaimer. |
| * 2. Redistributions in binary form must reproduce the above copyright |
| * notice, this list of conditions and the following disclaimer in the |
| * documentation and/or other materials provided with the distribution. |
| * 3. Neither the name of the copyright holder nor the |
| * names of its contributors may be used to endorse or promote products |
| * derived from this software without specific prior written permission. |
| * |
| * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" |
| * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
| * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE |
| * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE |
| * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR |
| * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF |
| * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS |
| * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN |
| * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) |
| * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE |
| * POSSIBILITY OF SUCH DAMAGE. |
| */ |
| |
| /** |
| * @file |
| * This file implements transmissions of SVR_DATA.ntf messages to the Leader. |
| */ |
| |
| #include "network_data_notifier.hpp" |
| |
| #if OPENTHREAD_FTD || OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE || OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE |
| |
| #include "common/code_utils.hpp" |
| #include "common/instance.hpp" |
| #include "common/locator_getters.hpp" |
| #include "common/log.hpp" |
| #include "thread/network_data_leader.hpp" |
| #include "thread/network_data_local.hpp" |
| |
| namespace ot { |
| namespace NetworkData { |
| |
| RegisterLogModule("NetworkData"); |
| |
| Notifier::Notifier(Instance &aInstance) |
| : InstanceLocator(aInstance) |
| , mTimer(aInstance, HandleTimer) |
| , mSynchronizeDataTask(aInstance, HandleSynchronizeDataTask) |
| , mNextDelay(0) |
| , mWaitingForResponse(false) |
| #if OPENTHREAD_FTD && OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE && OPENTHREAD_CONFIG_BORDER_ROUTER_REQUEST_ROUTER_ROLE |
| , mDidRequestRouterRoleUpgrade(false) |
| , mRouterRoleUpgradeTimeout(0) |
| #endif |
| { |
| } |
| |
| void Notifier::HandleServerDataUpdated(void) |
| { |
| #if OPENTHREAD_FTD && OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE && OPENTHREAD_CONFIG_BORDER_ROUTER_REQUEST_ROUTER_ROLE |
| mDidRequestRouterRoleUpgrade = false; |
| ScheduleRouterRoleUpgradeIfEligible(); |
| #endif |
| |
| mNextDelay = 0; |
| mSynchronizeDataTask.Post(); |
| } |
| |
| void Notifier::HandleSynchronizeDataTask(Tasklet &aTasklet) |
| { |
| aTasklet.Get<Notifier>().SynchronizeServerData(); |
| } |
| |
| void Notifier::SynchronizeServerData(void) |
| { |
| Error error = kErrorNotFound; |
| |
| VerifyOrExit(Get<Mle::MleRouter>().IsAttached() && !mWaitingForResponse); |
| |
| VerifyOrExit((mNextDelay == 0) || !mTimer.IsRunning()); |
| |
| #if OPENTHREAD_FTD |
| mNextDelay = kDelayRemoveStaleChildren; |
| error = Get<Leader>().RemoveStaleChildEntries(&Notifier::HandleCoapResponse, this); |
| VerifyOrExit(error == kErrorNotFound); |
| #endif |
| |
| #if OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE || OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE |
| mNextDelay = kDelaySynchronizeServerData; |
| error = Get<Local>().UpdateInconsistentServerData(&Notifier::HandleCoapResponse, this); |
| VerifyOrExit(error == kErrorNotFound); |
| #endif |
| |
| exit: |
| switch (error) |
| { |
| case kErrorNone: |
| mWaitingForResponse = true; |
| break; |
| case kErrorNoBufs: |
| mTimer.Start(kDelayNoBufs); |
| break; |
| #if OPENTHREAD_FTD |
| case kErrorInvalidState: |
| mTimer.Start(Time::SecToMsec(Get<Mle::MleRouter>().GetRouterSelectionJitterTimeout() + 1)); |
| break; |
| #endif |
| case kErrorNotFound: |
| break; |
| default: |
| OT_ASSERT(false); |
| OT_UNREACHABLE_CODE(break); |
| } |
| } |
| |
| void Notifier::HandleNotifierEvents(Events aEvents) |
| { |
| if (aEvents.ContainsAny(kEventThreadRoleChanged | kEventThreadChildRemoved)) |
| { |
| mNextDelay = 0; |
| } |
| |
| #if OPENTHREAD_FTD && OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE && OPENTHREAD_CONFIG_BORDER_ROUTER_REQUEST_ROUTER_ROLE |
| if (aEvents.Contains(kEventThreadPartitionIdChanged)) |
| { |
| mDidRequestRouterRoleUpgrade = false; |
| } |
| |
| if (aEvents.ContainsAny(kEventThreadRoleChanged | kEventThreadNetdataChanged | kEventThreadPartitionIdChanged)) |
| { |
| ScheduleRouterRoleUpgradeIfEligible(); |
| } |
| #endif |
| |
| if (aEvents.ContainsAny(kEventThreadNetdataChanged | kEventThreadRoleChanged | kEventThreadChildRemoved)) |
| { |
| SynchronizeServerData(); |
| } |
| } |
| |
| void Notifier::HandleTimer(Timer &aTimer) |
| { |
| aTimer.Get<Notifier>().HandleTimer(); |
| } |
| |
| void Notifier::HandleTimer(void) |
| { |
| SynchronizeServerData(); |
| } |
| |
| void Notifier::HandleCoapResponse(void *aContext, otMessage *aMessage, const otMessageInfo *aMessageInfo, Error aResult) |
| { |
| OT_UNUSED_VARIABLE(aMessage); |
| OT_UNUSED_VARIABLE(aMessageInfo); |
| |
| static_cast<Notifier *>(aContext)->HandleCoapResponse(aResult); |
| } |
| |
| void Notifier::HandleCoapResponse(Error aResult) |
| { |
| mWaitingForResponse = false; |
| |
| switch (aResult) |
| { |
| case kErrorNone: |
| mTimer.Start(mNextDelay + 1); |
| break; |
| |
| case kErrorResponseTimeout: |
| case kErrorAbort: |
| SynchronizeServerData(); |
| break; |
| |
| default: |
| OT_ASSERT(false); |
| OT_UNREACHABLE_CODE(break); |
| } |
| } |
| |
| #if OPENTHREAD_FTD && OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE && OPENTHREAD_CONFIG_BORDER_ROUTER_REQUEST_ROUTER_ROLE |
| |
| bool Notifier::IsEligibleForRouterRoleUpgradeAsBorderRouter(void) const |
| { |
| bool isEligible = false; |
| uint16_t rloc16 = Get<Mle::Mle>().GetRloc16(); |
| uint8_t activeRouterCount; |
| |
| VerifyOrExit(Get<Mle::MleRouter>().IsRouterEligible()); |
| |
| // RouterUpgradeThreshold can be explicitly set to zero in some of |
| // cert tests to disallow device to become router. |
| |
| VerifyOrExit(Get<Mle::MleRouter>().GetRouterUpgradeThreshold() != 0); |
| |
| // Check that we are a border router providing IP connectivity and already |
| // in the leader's network data and therefore eligible to request router |
| // role upgrade with `kBorderRouterRequest` status. |
| |
| VerifyOrExit(Get<Local>().ContainsBorderRouterWithRloc(rloc16) && |
| Get<Leader>().ContainsBorderRouterWithRloc(rloc16)); |
| |
| activeRouterCount = Get<RouterTable>().GetActiveRouterCount(); |
| VerifyOrExit((activeRouterCount >= Get<Mle::MleRouter>().GetRouterUpgradeThreshold()) && |
| (activeRouterCount < Mle::kMaxRouters)); |
| |
| VerifyOrExit(Get<Leader>().CountBorderRouters(kRouterRoleOnly) < Mle::kRouterUpgradeBorderRouterRequestThreshold); |
| isEligible = true; |
| |
| exit: |
| return isEligible; |
| } |
| |
| void Notifier::ScheduleRouterRoleUpgradeIfEligible(void) |
| { |
| // We allow device to request router role upgrade using status |
| // reason `kBorderRouterRequest` once while its local network data |
| // remains unchanged. This ensures if the leader is running an |
| // older version of Thread stack which does not support |
| // `kBorderRouterRequest` reason, we do not keep trying (on no |
| // response). The boolean `mDidRequestRouterRoleUpgrade` tracks |
| // this. It is set to `false` when local network data gets changed |
| // or when partition ID gets changed (indicating a potential |
| // leader change). |
| |
| VerifyOrExit(!mDidRequestRouterRoleUpgrade); |
| |
| VerifyOrExit(Get<Mle::MleRouter>().IsChild()); |
| VerifyOrExit(IsEligibleForRouterRoleUpgradeAsBorderRouter() && (mRouterRoleUpgradeTimeout == 0)); |
| |
| mRouterRoleUpgradeTimeout = Random::NonCrypto::GetUint8InRange(1, kRouterRoleUpgradeMaxTimeout + 1); |
| Get<TimeTicker>().RegisterReceiver(TimeTicker::kNetworkDataNotifier); |
| |
| exit: |
| return; |
| } |
| |
| void Notifier::HandleTimeTick(void) |
| { |
| VerifyOrExit(mRouterRoleUpgradeTimeout > 0); |
| |
| mRouterRoleUpgradeTimeout--; |
| |
| if (mRouterRoleUpgradeTimeout == 0) |
| { |
| Get<TimeTicker>().UnregisterReceiver(TimeTicker::kNetworkDataNotifier); |
| |
| // Check that we are still eligible for requesting router role |
| // upgrade (note that state can change since the last time we |
| // checked and registered to receive time ticks). |
| |
| if (Get<Mle::MleRouter>().IsChild() && IsEligibleForRouterRoleUpgradeAsBorderRouter()) |
| { |
| LogInfo("Requesting router role as BR"); |
| mDidRequestRouterRoleUpgrade = true; |
| IgnoreError(Get<Mle::MleRouter>().BecomeRouter(ThreadStatusTlv::kBorderRouterRequest)); |
| } |
| } |
| exit: |
| return; |
| } |
| #endif // OPENTHREAD_FTD && OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE && |
| // OPENTHREAD_CONFIG_BORDER_ROUTER_REQUEST_ROUTER_ROLE |
| |
| } // namespace NetworkData |
| } // namespace ot |
| |
| #endif // OPENTHREAD_FTD || OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE || OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE |