[nexus] migrate child supervision test to nexus (#12935)

This commit migrates the functional test for child supervision from
the thread-cert Python-based framework to the Nexus framework.

The original test in 'tests/scripts/thread-cert/test_child_supervision.py'
has been removed and replaced with a C++ implementation in
'tests/nexus/test_child_supervision.cpp'.

The new Nexus test covers:
- Verification of initial child supervision interval on parent and child.
- Dynamically updating the supervision interval and check timeout.
- Behavior when supervision messages are blocked (child detaching).
- Verification of connectivity when child supervision is disabled.
- Handling of zero supervision interval.

'tests/nexus/CMakeLists.txt' is updated to include the new test.
This commit is contained in:
Jonathan Hui
2026-04-20 02:09:19 -05:00
committed by GitHub
parent 2145cda437
commit a07c892270
3 changed files with 170 additions and 189 deletions
@@ -1,189 +0,0 @@
#!/usr/bin/env python3
#
# Copyright (c) 2022, 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.
#
import unittest
import command
import config
import thread_cert
# Test description:
#
# This test verifies behavior child supervision.
#
#
# Topology:
#
# Parent (leader)
# |
# |
# Child (sleepy).
PARENT = 1
CHILD = 2
class ChildSupervision(thread_cert.TestCase):
USE_MESSAGE_FACTORY = False
SUPPORT_NCP = False
TOPOLOGY = {
PARENT: {
'name': 'PARENT',
'mode': 'rdn',
},
CHILD: {
'name': 'CHILD',
'is_mtd': True,
'mode': 'n',
},
}
def test(self):
parent = self.nodes[PARENT]
child = self.nodes[CHILD]
# Form the network.
parent.start()
self.simulator.go(config.LEADER_STARTUP_DELAY)
self.assertEqual(parent.get_state(), 'leader')
child.start()
self.simulator.go(5)
self.assertEqual(child.get_state(), 'child')
child.set_pollperiod(500)
self.assertEqual(int(child.get_child_supervision_check_failure_counter()), 0)
# Check the parent's child table.
table = parent.get_child_table()
self.assertEqual(len(table), 1)
self.assertEqual(table[1]['suprvsn'], int(child.get_child_supervision_interval()))
# Change the supervision interval on child. This should trigger an
# MLE Child Update exchange from child to parent so to inform parent
# about the change. Verify that parent is notified by checking the
# parent's child table.
child.set_child_supervision_interval(20)
self.simulator.go(2)
self.assertEqual(int(child.get_child_supervision_interval()), 20)
table = parent.get_child_table()
self.assertEqual(len(table), 1)
self.assertEqual(table[1]['suprvsn'], int(child.get_child_supervision_interval()))
# Change supervision check timeout on the child.
child.set_child_supervision_check_timeout(25)
self.assertEqual(int(child.get_child_supervision_check_timeout()), 25)
# Wait for multiple supervision intervals and ensure that child
# stays attached (child supervision working as expected).
self.simulator.go(110)
self.assertEqual(child.get_state(), 'child')
table = parent.get_child_table()
self.assertEqual(len(table), 1)
self.assertEqual(int(child.get_child_supervision_check_failure_counter()), 0)
# Disable supervision check on child.
child.set_child_supervision_check_timeout(0)
# Enable allowlist on parent without adding the child. After child
# timeout expires, the parent should remove the child from its child
# table.
parent.clear_allowlist()
parent.enable_allowlist()
table = parent.get_child_table()
child_timeout = table[1]['timeout']
self.simulator.go(child_timeout + 1)
table = parent.get_child_table()
self.assertEqual(len(table), 0)
# Since supervision check is disabled on the child, it should
# continue to stay attached to parent (since data polls are acked by
# radio driver).
self.assertEqual(child.get_state(), 'child')
self.assertEqual(int(child.get_child_supervision_check_failure_counter()), 0)
# Re-enable supervision check on child. After the check timeout the
# child must try to exchange "Child Update" messages with parent and
# then detect that parent is not responding and detach.
child.set_child_supervision_check_timeout(25)
self.simulator.go(35)
self.assertEqual(child.get_state(), 'detached')
self.assertTrue(int(child.get_child_supervision_check_failure_counter()) > 0)
# Disable allowlist on parent. Child should be able to attach again.
parent.disable_allowlist()
self.simulator.go(30)
self.assertEqual(child.get_state(), 'child')
child.reset_child_supervision_check_failure_counter()
self.assertEqual(int(child.get_child_supervision_check_failure_counter()), 0)
# Set the supervision interval to zero on child (child is asking
# parent not to supervise it anymore). This practically behaves
# the same as if parent does not support child supervision
# feature.
child.set_child_supervision_interval(0)
child.set_child_supervision_check_timeout(25)
self.simulator.go(2)
self.assertEqual(int(child.get_child_supervision_interval()), 0)
self.assertEqual(int(child.get_child_supervision_check_timeout()), 25)
table = parent.get_child_table()
self.assertEqual(len(table), 1)
self.assertEqual(table[2]['suprvsn'], int(child.get_child_supervision_interval()))
# Wait for multiple check timeouts. The child should still stay
# attached to parent.
self.simulator.go(100)
self.assertEqual(child.get_state(), 'child')
self.assertEqual(len(parent.get_child_table()), 1)
self.assertTrue(int(child.get_child_supervision_check_failure_counter()) > 0)
if __name__ == '__main__':
unittest.main()