| /* |
| * Copyright (c) 2019, 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 includes compile-time configurations for Parent Search. |
| * |
| */ |
| |
| #ifndef CONFIG_PARENT_SEARCH_H_ |
| #define CONFIG_PARENT_SEARCH_H_ |
| |
| /** |
| * @def OPENTHREAD_CONFIG_PARENT_SEARCH_ENABLE |
| * |
| * Define as 1 to enable periodic parent search feature. |
| * |
| * When this feature is enabled an end-device/child (while staying attached) will periodically search for a possible |
| * better parent and will switch parent if a better one is found. |
| * |
| * The child will periodically check the average RSS value for the current parent, and only if it is below a specific |
| * threshold, a parent search is performed. The `OPENTHREAD_CONFIG_PARENT_SEARCH_CHECK_INTERVAL` specifies the |
| * check interval (in seconds) and `OPENTHREAD_CONFIG_PARENT_SEARCH_RSS_THRESHOLD` gives the RSS threshold. |
| * |
| * Since the parent search process can be power consuming (child needs to stays in RX mode to collect parent response) |
| * and to limit its impact on battery-powered devices, after a parent search is triggered, the child will not trigger |
| * another one before a specified backoff interval specified by `OPENTHREAD_CONFIG_PARENT_SEARCH_BACKOFF_INTERVAL`. |
| * |
| */ |
| #ifndef OPENTHREAD_CONFIG_PARENT_SEARCH_ENABLE |
| #define OPENTHREAD_CONFIG_PARENT_SEARCH_ENABLE 0 |
| #endif |
| |
| /** |
| * @def OPENTHREAD_CONFIG_PARENT_SEARCH_CHECK_INTERVAL |
| * |
| * Specifies the interval in seconds for a child to check the trigger condition to perform a parent search. |
| * |
| * Applicable only if periodic parent search feature is enabled (see `OPENTHREAD_CONFIG_PARENT_SEARCH_ENABLE`). |
| * |
| */ |
| #ifndef OPENTHREAD_CONFIG_PARENT_SEARCH_CHECK_INTERVAL |
| #define OPENTHREAD_CONFIG_PARENT_SEARCH_CHECK_INTERVAL (9 * 60) |
| #endif |
| |
| /** |
| * @def OPENTHREAD_CONFIG_PARENT_SEARCH_BACKOFF_INTERVAL |
| * |
| * Specifies the backoff interval in seconds for a child to not perform a parent search after triggering one. |
| * |
| * Applicable only if periodic parent search feature is enabled (see `OPENTHREAD_CONFIG_PARENT_SEARCH_ENABLE`). |
| * |
| * |
| */ |
| #ifndef OPENTHREAD_CONFIG_PARENT_SEARCH_BACKOFF_INTERVAL |
| #define OPENTHREAD_CONFIG_PARENT_SEARCH_BACKOFF_INTERVAL (10 * 60 * 60) |
| #endif |
| |
| /** |
| * @def OPENTHREAD_CONFIG_PARENT_SEARCH_RSS_THRESHOLD |
| * |
| * Specifies the RSS threshold used to trigger a parent search. |
| * |
| * Applicable only if periodic parent search feature is enabled (see `OPENTHREAD_CONFIG_PARENT_SEARCH_ENABLE`). |
| * |
| */ |
| #ifndef OPENTHREAD_CONFIG_PARENT_SEARCH_RSS_THRESHOLD |
| #define OPENTHREAD_CONFIG_PARENT_SEARCH_RSS_THRESHOLD -65 |
| #endif |
| |
| #endif // CONFIG_PARENT_SEARCH_H_ |