User Guide Getting Started

Getting Started

This guide walks you through building your first RTIC application using an existing distribution.

Prerequisites

• A working Rust toolchain (the latest stable release is recommended).
• The target toolchain for your chosen distribution. For example, for the RP2040 examples you need:

  rustup target add thumbv6m-none-eabi

Choose a distribution

This repository ships several reference distributions. Pick one that matches your hardware or simulator:

Distribution	Target	Good for
rp2040-rtic	Raspberry Pi Pico / RP2040	Getting started, single-core and multicore examples
stm32-renode-rtic	Renode-simulated STM32F1C3-like	Multicore simulation
rtic-hippo	RISC-V Hippomenes	Single-core RISC-V experiments
atalanta-rtic	RISC-V Atalanta	Single-core RISC-V experiments

Create your own application

1. Create a new Rust binary crate that depends on one of the distributions, e.g.:

   [dependencies]
   xxx-rtic = { path = "path/or/version/to/distributions/xxx-rtic" }

2. Write an RTIC application using the attributes described in the Syntax Reference.
3. Build and flash/run as appropriate for your target.

Next steps

• Read the Syntax Reference to learn the supported attributes.
• Check the Supported Distributions page for feature flags and target details.