User Guide Supported Distributions

Supported Distributions

This page lists the reference distributions. rticx-cortex-m is maintained in this repository; rticx-riscv and rticx-rp2040 live in their own repositories. New distributions for other hardware targets are developed as out-of-tree crates.

Distribution	Repository	Target	Features	Notes
rticx-cortex-m	distributions/rticx-cortex-m/ (this repo)	Single-core Cortex-M (armv6-m and armv7-m and above)	swtasks (default), armv6m, async	BASEPRI locking by default; armv6m feature switches to interrupt source masking.
rticx-riscv	https://github.com/rticx-rs/rticx-riscv	Single-core riscv with generic SLIC interrupt controller/ esp32c3/ esp32c6	See README.md of the distro	-
rticx-rp2040	https://github.com/rticx-rs/rticx-rp2040	Raspberry Pi Pico / RP2040 dual-core Cortex-M0+	autoassign, swtasks, async	Single binary; starts core 1 from post_init.

Feature descriptions

• async: enables the rticx-async-pass async/await software tasks pass.
• swtasks: enables the rticx-sw-pass software tasks pass (dispatchers, message queues, spawn, cross_spawn).
• armv6m: (rticx-cortex-m only) selects interrupt source-masking locking (Cortex-M0/M0+/M23). When disabled, BASEPRI-based locking is used (armv7-m and above).
• autoassign: enables the rticx-auto-assign pass for automatic core = N assignment.
• deadline-pass: enables the rticx-deadline-pass deadlines-to-priorities conversion.

Creating a new distribution

If you want to support new hardware, you create a new distribution crate outside of this repository. The Distributor Guide explains how to implement the required backend traits and register compilation passes.