Parent Search

This module includes configuration variables for Parent Search.

Summary

Macros

OPENTHREAD_CONFIG_PARENT_SEARCH_BACKOFF_INTERVAL (10 * 60 * 60)
Specifies the backoff interval in seconds for a child to not perform a parent search after triggering one.
OPENTHREAD_CONFIG_PARENT_SEARCH_CHECK_INTERVAL (9 * 60)
Specifies the interval in seconds for a child to check the trigger condition to perform a parent search.
OPENTHREAD_CONFIG_PARENT_SEARCH_ENABLE 0
Define as 1 to enable periodic parent search feature.
OPENTHREAD_CONFIG_PARENT_SEARCH_RSS_THRESHOLD -65
Specifies the RSS threshold used to trigger a parent search.

Macros

OPENTHREAD_CONFIG_PARENT_SEARCH_BACKOFF_INTERVAL

 OPENTHREAD_CONFIG_PARENT_SEARCH_BACKOFF_INTERVAL (10 * 60 * 60)

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).

OPENTHREAD_CONFIG_PARENT_SEARCH_CHECK_INTERVAL

 OPENTHREAD_CONFIG_PARENT_SEARCH_CHECK_INTERVAL (9 * 60)

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).

OPENTHREAD_CONFIG_PARENT_SEARCH_ENABLE

 OPENTHREAD_CONFIG_PARENT_SEARCH_ENABLE 0

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.

OPENTHREAD_CONFIG_PARENT_SEARCH_RSS_THRESHOLD

 OPENTHREAD_CONFIG_PARENT_SEARCH_RSS_THRESHOLD -65

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).

Resources

OpenThread API Reference topics originate from the source code, available on GitHub. For more information, or to contribute to our documentation, refer to Resources.