User Guide Supported Distributions

Supported Distributions

This page lists the reference distributions maintained in this repository. New distributions for other hardware targets are developed as out-of-tree crates.

Distribution	Path	Target	Features	Notes
rticx-cortex-m	distributions/rticx-cortex-m/	Single-core Cortex-M (armv6-m and armv7-m and above)	swtasks (default), armv6m	BASEPRI locking by default; armv6m feature switches to interrupt source masking.
rticx-rp2040	distributions/rticx-rp2040/	Raspberry Pi Pico / RP2040 dual-core Cortex-M0+	autoassign, swtasks	Single binary; starts core 1 from post_init.
rticx-stm32-renode	distributions/rticx-stm32-renode/	Renode-simulated multicore STM32F1C3-like	N/A	Multi-binary build: compile each core separately.
rticx-hippo	distributions/rticx-hippo/	Single-core RISC-V Hippomenes MCU	deadline-pass	Uses threshold-based (mintthresh) locking.
rticx-atalanta	distributions/rticx-atalanta/	Single-core RISC-V Atalanta MCU	deadline-pass
distribution-template	distributions/distribution-template/	Reference / template	—	Conceptual starting point for new distributions; not expected to compile.

Feature descriptions

• swtasks — enables the rticx-sw-pass software tasks pass (dispatchers, message queues, spawn, spawn_from).
• 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.