-
Notifications
You must be signed in to change notification settings - Fork 1
Changelogs
Rylan Meilutis edited this page Mar 27, 2026
·
23 revisions
- Time sync election and continuity:
-
Sourcerouters now participate in producer election instead of always acting as masters. - Routers keep per-remote-source time state instead of collapsing all remotes into one shared internal source slot.
- Non-winning producers now follow the elected leader rather than continuing to serve independently.
- Failover now uses monotonic holdover plus slew so network time does not jump backward during source changes.
-
- Tie breaking and consumer promotion:
- Same-priority producers now resolve leadership by selecting one winner and advertising a temporary boosted priority while the standby producers keep their configured priorities.
- Consumers with a non-uptime-based clock can optionally self-promote when no producers remain, allowing the network to stay aligned during complete producer loss.
- Docs and tooling updates:
- Added C ABI discovery maintenance hooks so C callers can force a discovery announce or poll for due discovery traffic on both routers and relays.
- Added Rust system-test coverage for election, priority ties, consumer promotion, and failover monotonicity.
- Wiki source links now default to GitHub in-repo, while the wiki sync script rewrites them to the target GitLab repo path when publishing to GitLab.
- Full changelog: v3.4.1...v3.4.2
- Discovery and time sync routing integration:
- Added built-in
DISCOVERY_TIMESYNC_SOURCESadvertisements so routers and relays can learn concrete reachable time source sender IDs instead of only genericTIME_SYNCendpoint reachability. -
TIME_SYNCrequests now prefer exact discovered source paths when the current selected source is known through discovery. -
export_topology()now includes advertised and reachable time source IDs alongside endpoint reachability.
- Added built-in
- Time sync failover and traffic reduction:
-
TimeSyncTrackernow keeps the active source set and can fail over immediately to a same-priority or lower-priority standby source that is still active. - Source-generated
TIME_SYNC_RESPONSEtraffic now returns to the requesting ingress side instead of being broadcast to every side. - Fixed an internal request-serving deadlock by avoiding timesync mutex re-entry while sampling source-side timestamps.
- Full changelog: v3.4.0...v3.4.1
-
- Router-managed time sync and network clock:
- Time sync is now handled internally by the router instead of through normal local
TIME_SYNCendpoint handlers. - Routers maintain an internal non-monotonic network clock separate from their monotonic timing source.
- Packet timestamps now prefer the internal network clock when one is available.
- Time sync is now handled internally by the router instead of through normal local
- Partial time-source merging and master clock injection:
- The internal network clock can merge partial sources, such as date from one source and time-of-day or subsecond precision from another.
- Added master/local time setter APIs for complete or partial network time, including date-only, hour/minute, hour/minute/second, millisecond, and nanosecond variants.
- Local time setters are anchored at commit time so short context switches during updates do not leave complete absolute times stale.
- Constructor and FFI clock model updates:
- On
stdbuilds,Router::new(...)now uses an internal monotonic clock by default. - Added
Router::new_with_clock(...)for tests, simulation, andno_std/ embedded clock injection. - C and Python router constructors now treat the monotonic clock callback as optional on
stdbuilds and fall back to the internal router clock when it is omitted.
- On
- C system-test and harness improvements:
- Fixed a relay timing issue in the C system-test path that could cause shutdown to stall.
- Updated C time-sync tests to follow the internal router-managed time-sync model.
- Added bounded timeout handling in the Rust C-test harness so future regressions fail fast instead of hanging indefinitely.
- Documentation refresh:
- Updated Rust, C, and Python usage docs to reflect the new router constructor model.
- Expanded time-sync documentation to cover the internal network clock, merged partial sources, current network time accessors, and master-side setter APIs.
- Full changelog: v3.3.0...v3.4.0
- Discovery/routing control plane:
- Added built-in discovery advertisements for routers and relays under the
discoveryfeature. - Routers and relays now learn endpoint reachability, export topology snapshots, and use adaptive announce intervals that speed up after topology changes and back off when stable.
- Selective forwarding now uses discovered reachability first and falls back to ordinary flooding when routes are unknown.
- Added built-in discovery advertisements for routers and relays under the
- Reliability and forwarding integration:
- Reliable packets are now fanned out to all discovered candidate sides instead of relying only on blind flooding.
- Added additional routing tests to ensure discovery does not cause link-local traffic to leak onto normal network sides.
- Link-local/software-bus IPC support:
- Added link-local-only endpoint support for software-bus / IPC traffic.
- Discovery advertisements are filtered per-side so IPC endpoints are not exposed on non-link-local links.
- Routers and relays now enforce link-local routing boundaries even when discovery data is overly broad.
- Split schema support for per-board IPC:
- Added
SEDSPRINTF_RS_IPC_SCHEMA_PATHfor board-local IPC overlays that merge with the shared base schema. - IPC overlay endpoints are treated as link-local automatically; base-schema endpoints are treated as non-link-local automatically.
- Added proc-macro/build-script tests for overlay merging, collision rejection, and link-local normalization.
- Added
- Telemetry config editor updates:
- The GUI editor can now open, edit, and save the base schema and IPC overlay as separate files.
- IPC overlay paths can live outside the repository and be supplied by environment-driven build systems such as
CMake or
.cargo/config.toml. - Link-local scope is now derived from which file is being edited rather than being a user-editable checkbox.
- Full changelog: v3.2.3...v3.3.0
- Compression backend consolidation:
- Switched to a single backend (
zstd-safe) for sender/payload compression. - Removed compression-level configuration knobs from build/docs/examples.
- Kept bounded compression behavior and added constrained-memory regression tests.
- Switched to a single backend (
- Router/FFI queueing and re-entrancy hardening:
- RX queue paths and lock behavior were tightened to avoid deadlocks under RTOS-like concurrency.
- Added tests for handler re-entry into router APIs and mixed ingress/processing concurrency.
- Time sync validation expansion:
- Added C system tests for multi-node time sync and board-topology scenarios (grandmaster + consumers).
- Added failover coverage where backup sources are selected after source timeout.
- C/C++ integration updates:
- Expanded C header template function descriptions.
- macOS C system-test builds now align deployment target settings with Rust staticlib builds to avoid linker mismatch warnings.
- Full changelog: v3.2.2...v3.2.3
- Script reliability and UX improvements: better error handling with actionable failure hints across update/build/docs helper scripts.
- Formatting cleanup across scripts and docs for more consistent output.
- Additional wiki documentation updates and wording cleanup.
- Full changelog: v3.2.1...v3.2.2
- Wiki overhaul: broad documentation refresh, structure cleanup, and improved navigation/discoverability.
- GUI updates to the telemetry config editor.
- Full changelog: v3.2.0...v3.2.1
- Time Sync feature: built-in
TIME_SYNCendpoint andTIME_SYNC_*packet types (enabled viatimesyncfeature). - New Time Sync helpers and improved failover handling in
TimeSyncTracker. - New Rust, C, and Python time sync examples plus additional Rust examples for relay, reliability, timeouts, and multi-node simulation.
- RTOS time sync example code for FreeRTOS and ThreadX.
- Updated wiki docs to surface new examples and feature behavior.
- Full changelog: v3.1.0...v3.2.0
What's included:
- Feature:
timesyncaddsTIME_SYNCendpoint andTIME_SYNC_ANNOUNCE/REQUEST/RESPONSEtypes (built-in likeTelemetryError). - Examples: rust-example-code/timesync_example.rs (source), rust-example-code/relay_example.rs (source), rust-example-code/reliable_example.rs (source), rust-example-code/queue_timeout_example.rs (source), rust-example-code/multinode_sim_example.rs (source), c-example-code/src/timesync_example.c (source), python-example/timesync_example.py (source), rtos-example-code/freertos_timesync.c (source), rtos-example-code/threadx_timesync.c (source).
- C system test and examples demonstrate Time Sync announce/request/response flows.
- Python example handles Time Sync without re-entering the router from handlers.
- CRC support for packets to ensure validity; in reliable mode, CRC failures trigger retransmits.
- Fixes to the config editor GUI.
- Full changelog: v3.0.0...v3.1.0
- Router side tracking is internal. Most applications should call the plain RX APIs (
rx_serialized/rx) and only use side-aware variants when explicitly overriding ingress (custom relays, multi-link bridges, etc.). - TCP-like reliability is now available for schema types marked
reliable/reliable_mode, with ACKs, retransmits, and optional ordering. Enable per side and disable when the transport is already reliable. - Full changelog: v2.4.0...v3.0.0
- Moved config to environment + JSON schema used at compile time.
- Added a simple GUI tool for building the config.
- Full changelog: v2.3.2...v2.4.0
- Added a new unsafe API for creating link IDs.
- Fixed existing bugs.
- Full changelog: v2.3.1...v2.3.2
- Simplified config format is now live and in production.
- Full changelog: v2.2.3...v2.3.0
- Build script fixes and more repo details.
- Final fix for bounded ring buffers used in routers and relays.
- Full changelog: v2.2.1...v2.2.3
- Link-aware router for relay mode, reducing reliance on dedupe to prevent loops.
- Full changelog: v2.2.0...v2.2.1
- Improved relay handling with side-aware routing and transmit callbacks.
- Added a new full system test.
- Full changelog: v2.0.0...v2.1.0
- Added
RouterMode(Relay vs Sink) behavior. - Fixed a bug where packet hashes were not saved, causing double processing.
- Full changelog: v1.5.2...v2.0.0
- Added max queue size controls plus ring buffer behavior to prevent unbounded growth and heap overruns.
- Full changelog: v1.5.1...v1.5.2
- Reduced memory usage for stack-stored packet payloads and overall memory footprint.
- Full changelog: v1.5.0...v1.5.1
- Added payload and sender string compression with configurable thresholds.
- Full changelog: v1.4.0...v1.5.0
- Added packet dedupe prevention.
- Improved README and added scripts for submodule usage and compile-time sender string setting.
- Full changelog: v1.2.0...v1.4.0
- Added relay support for transporting packets across protocols (e.g., CAN to UART).
- Full changelog: v1.1.1...v1.2.0
- Fixed broadcast behavior when all consumers have handlers or endpoints.
- Added support for packets containing no data.
- Full changelog: v1.1.0...v1.1.1
- Renamed hex data type to binary data.
- Fixed C API handling for 128-bit integers.
- Improved build script and update subtree script.
- Updated documentation.
- Performance optimizations and documentation improvements.
- Added error logging in no_std builds (requires external function hook).
- First stable release with routing, serialization, and packet creation across C, Rust, and Python.
- Marked API as stable.