Development

Current setup is based on cortex-m-quickstart and requires Rust nightly.

With Nix

Nix setup uses flakes feature.

To enable flakes add the following to Nix config:

experimental-features = nix-command flakes

Nix development shell will have nightly Rust and the following build targets available: Cortex-M3, Cortex-M4/M7, and Cortex-M4F/M7F.

To start development shell:

nix develop

This setup also includes a development shell with QEMU emulator available. To run shell with QEMU:

nix develop .#withQemu

Be aware, that shell with QEMU will download QEMU (~1.5 Gb). Runnable example can be found in qemu-example, e.g. from repository root run:

nix develop .#withQemu

# when shell is ready
cd examples/qemu-example/
cargo run --release

If everything works you should see "Test: Generating keys" and pair of keys in console output.

If you want to install everything yourself from scratch please refer to cortex-m-quickstart instructions.