Child Supervision

This module includes configuration variables for Child Supervision.

Summary

Macros
OPENTHREAD_CONFIG_CHILD_SUPERVISION_CHECK_TIMEOUT 190	The default supervision check timeout interval (in seconds) used by a device in child state.
OPENTHREAD_CONFIG_CHILD_SUPERVISION_INTERVAL 129	The default supervision interval in seconds to use when in child state.
OPENTHREAD_CONFIG_CHILD_SUPERVISION_OLDER_VERSION_CHILD_DEFAULT_INTERVAL 129	Specifies the default supervision interval to use on parent for children that do not explicitly indicate their desired supervision internal (do not include a "Supervision Interval TLV") and are running older Thread versions (version <= 1.3.0).

Macros

OPENTHREAD_CONFIG_CHILD_SUPERVISION_CHECK_TIMEOUT

 OPENTHREAD_CONFIG_CHILD_SUPERVISION_CHECK_TIMEOUT 190

The default supervision check timeout interval (in seconds) used by a device in child state.

Set to zero to disable the supervision check process on the child.

The check timeout interval can be changed using otChildSupervisionSetCheckTimeout().

If the sleepy child does not hear from its parent within the specified timeout interval, it initiates the re-attach process (MLE Child Update Request/Response exchange with its parent).

OPENTHREAD_CONFIG_CHILD_SUPERVISION_INTERVAL

 OPENTHREAD_CONFIG_CHILD_SUPERVISION_INTERVAL 129

The default supervision interval in seconds to use when in child state.

Zero indicates no supervision needed.

The current supervision interval can be changed using otChildSupervisionSetInterval().

Child supervision feature provides a mechanism for parent to ensure that a message is sent to each sleepy child within the supervision interval. If there is no transmission to the child within the supervision interval, child supervisor will enqueue and send a supervision message (a data message with empty payload) to the child.

OPENTHREAD_CONFIG_CHILD_SUPERVISION_OLDER_VERSION_CHILD_DEFAULT_INTERVAL

 OPENTHREAD_CONFIG_CHILD_SUPERVISION_OLDER_VERSION_CHILD_DEFAULT_INTERVAL 129

Specifies the default supervision interval to use on parent for children that do not explicitly indicate their desired supervision internal (do not include a "Supervision Interval TLV") and are running older Thread versions (version <= 1.3.0).

This config is added to allow backward compatibility on parent with SED children that used Child Supervision feature in OT stack before adoption of it by Thread specification and addition of the "Supervision Interval TLV" as the mechanism for child to inform the parent of its desired supervision interval.

The config can be set to zero to effectively disable it, i.e., if a child does not provide "Supervision Interval TLV" it indicates that it does not want to be supervised and then parent will use zero interval for the child.

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.