mirror of https://github.com/espressif/openthread.git synced 2026-10-14 19:57:40 +00:00

Files

T

Abtin Keshavarzian 5c8c318627 [sub-mac] introduce unified ReceiveAt logic for timed RX (#13491 )

This commit introduces a unified `ReceiveAt` abstraction in `SubMac` to
handle timed reception windows (CSL receiver, WED / Thread-Direct wakeup
listener)

Motivation & Benefits:

Previously, CSL sample window calculation and scheduling differed between
platform-offloaded timing (`OT_RADIO_CAPS_RECEIVE_TIMING`) and stack-driven
timing (`SubMac` software timers):
- `GetCslWindowEdges()` added `kCslReceiveTimeAhead` lead time to the window
  margin, only for offloaded callers to manually subtract it back out before
  calling `Radio::ReceiveAt()`.
- Stack-driven mode relied on separate timers for sample/sleep transitions
  (`HandleCslReceiveOrSleep`, `HandleWedReceiveOrSleep`), leading to code
  duplication and inconsistent timing margins across platform vs stack-driven
  executions.

This commit harmonizes timed reception handling:
- `GetCslWindowEdges()` cleanly computes target window bounds without caller-side
  adjustments.
- `SubMac::ReceiveAt()` provides a single, consistent API for both offloaded
  and stack-driven timing.
- Provides a clean foundation for Thread-Direct wakeup listening (WED) and
  future timed reception features.

Key changes:

- State Machine Refactoring: Simplifies the state management adding
  `kStateTimedReceive`. The radio state is `kStateTimedReceive` when
  actively receiving in a target rx window, and `kStateSleep` otherwise.
- `TimedRx` Helper Class: Encapsulates window parameters (`mStartTime`,
  `mDuration`, `mChannel`) and state checks (`HasStarted`, `HasEnded`).
- Pending & Active Window Preemption: `UpdateTimedRxState()` manages
  the timed RX schedules and sets the timer accordingly. It ensures
  pending windows starting before an active window ends are promoted
  seamlessly.
- Unit Test: Adds a detailed `test_sub_mac_recv_at.cpp` covering various
  behaviors (including edge-cases) of `ReceiveAt()` logic.

2026-08-31 14:27:24 -07:00

cli

[netdiag] add support for Vendor OUI TLV (#13260 )

2026-06-24 23:17:59 -07:00

ncp

[test] add code spell check and correct wrong spelling (#9066 )

2023-05-22 18:04:09 -07:00

build.sh

[toranj] add --log-level option to build.sh (#11840 )

2025-08-22 14:30:39 -07:00

openthread-core-toranj-config-posix.h

[srp-client] add counters for performance tracking (#13137 )

2026-08-17 17:31:02 -07:00

openthread-core-toranj-config-simulation.h

[sub-mac] introduce unified ReceiveAt logic for timed RX (#13491 )

2026-08-31 14:27:24 -07:00

openthread-core-toranj-config.h

[tcp] add OPENTHREAD_CONFIG_TCP_ENABLE guards to headers (#13195 )

2026-06-03 08:29:35 -07:00

README_CLI.md

[toranj] update build.sh script to use CMake for all builds (#9115 )

2023-06-01 21:39:45 -07:00

README_NCP.md

[mac] remove beacons payload (#7472 )

2022-04-06 12:18:22 -07:00

README.md

[toranj] add support for CLI based test-cases (#7258 )

2022-03-22 14:28:08 -07:00

start.sh

[history-tracker] add client/server for remote query (#11757 )

2025-12-09 10:34:06 -08:00

README.md

`toranj` test framework

toranj is a test framework for OpenThread.

It provides two modes:

toranj-cli which enables testing of OpenThread using its CLI interface.
toranj-ncp which enables testing of the combined behavior of OpenThread (in NCP mode), spinel interface, and wpantund driver on linux.

toranj features:

It is developed in Python.
It can be used to simulate multiple nodes forming complex network topologies.
It allows testing of network interactions between many nodes (IPv6 traffic exchanges).
toranj in NCP mode runs wpantund natively with OpenThread in NCP mode on simulation platform (real-time).
toranj in CLI mode runs ot-cli-ftd on simulation platform (real-time).
toranj tests run as part of GitHub Actions pull request validation in OpenThread and wpantund GitHub projects.

`toranj` modes

What does "toranj" mean? it's the name of a common symmetric weaving pattern used in Persian carpets.

README.md

toranj test framework

toranj modes

`toranj` test framework

`toranj` modes