## Keyboard shortcuts

Press `←` or `→` to navigate between chapters

Press `S` or `/` to search in the book

Press `?` to show this help

Press `Esc` to hide this help

# RTIC by example

This part of the book introduces the Real-Time Interrupt-driven Concurrency (RTIC) framework to new users by walking them through examples of increasing complexity.

All examples in this part of the book are accessible at the GitHub repository. The examples are runnable on QEMU (emulating a Cortex M3 target), thus no special hardware required to follow along.

To run the examples with QEMU you will need the `qemu-system-arm` program. Check the embedded Rust book for instructions on how to set up an embedded development environment that includes QEMU.

To run the examples found in `examples/` locally, cargo needs a supported `target` and either `--examples` (run all examples) or `--example NAME` to run a specific example.

Assuming dependencies in place, running:

    $ cargo run --target thumbv7m-none-eabi --example locals

Yields this output:

    foo: local_to_foo = 1
    bar: local_to_bar = 1
    idle: local_to_idle = 1

> NOTE: You can choose target device by passing a target triple to cargo (e.g. `cargo run --example init --target thumbv7m-none-eabi`) or configure a default target in `.cargo/config.toml`.

> For running the examples, we use a Cortex M3 emulated in QEMU, so the target is `thumbv7m-none-eabi`.