Files
Jonathan Hui 66fbd918d7 [tests] fix flakiness in Nexus test 1.2.LP.5.3.8 (#12629)
This commit stabilizes Nexus test 1.2.LP.5.3.8 by addressing timing
issues related to SSED polling during network transitions.

Key changes:
- In test_1_2_LP_5_3_8.cpp, added StopPolling() calls after MLE and
  MeshCoP exchanges to suppress immediate Data Requests triggered by
  these protocols. This ensures the SSED satisfies strict 'no Data
  Request' pass criteria.
- In verify_1_2_LP_5_3_8.py, updated criteria 13.2 to allow Data
  Requests on the Ternary Channel that occur during the initial
  network transition (re-attachment). The script now only strictly
  disallows Data Requests in the 1-second window immediately
  preceding the Echo Request.

These changes make the test robust against standard OpenThread
re-synchronization behavior while still verifying that Echo Requests
are received via CSL synchronization.
2026-03-05 16:26:59 -06:00
..

Nexus test framework

Nexus is a test framework for OpenThread testing.

Design Goals

  • Faster and more scalable network simulation: Enable faster and more efficient simulations of OpenThread networks involving a large number of nodes over extended durations.
  • Enhanced control: Achieve greater control and scalability over simulated tests.

Features

  • Includes the Nexus platform implementation that emulates platform behavior, allowing multiple nodes running the OpenThread core stack to be simulated and interact with each other within the same process.
  • Unlike the simulation platform (under examples/platforms/simulation), where nodes run in separate processes and interact via POSIX sockets, Nexus nodes are simulated within a single process.
  • Nexus tests can interact directly with the C++ or C OT core APIs, providing more control than the simulation platform's CLI-based interactions.
  • The flow of time in Nexus tests is directly controlled by the test itself, allowing for quick time interval advancement.

How to build and run tests

To build Nexus test cases, the tests/nexus/build.sh script can be used:

top_builddir=nexus_test ./tests/nexus/build.sh

By default, the script builds for IEEE 802.15.4. To build for TREL tests, use the trel argument:

top_builddir=nexus_test ./tests/nexus/build.sh trel

Automated testing and packet verification

The tests/nexus/run_nexus_tests.sh script automates the process of running tests and performing packet verification using corresponding Python scripts.

To run all default tests:

top_builddir=nexus_test ./tests/nexus/run_nexus_tests.sh

To run a specific test:

top_builddir=nexus_test ./tests/nexus/run_nexus_tests.sh 5_1_1

The script runs the Nexus C++ test (which generates a JSON file and optionally a PCAP file) and then executes the Python verification script (e.g., verify_5_1_1.py) if it exists. Artifacts for each test are preserved in a temporary directory if the test fails.

Manual execution

Each test can be run directly from the build directory. C++ tests typically take a topology name (if applicable) and a JSON output filename as arguments.

./nexus_test/tests/nexus/nexus_6_1_1 A test_6_1_1.json

The verification script can then be run manually:

python3 ./tests/nexus/verify_6_1_1.py test_6_1_1.json