This template is intended as a starting point for developing your own firmware based on the rp2040-hal.
It includes all of the knurling-rs tooling as showcased in https://github.com/knurling-rs/app-template (defmt, defmt-rtt, panic-probe, flip-link) to make development as easy as possible.
probe-run-rp is configured as the default runner, so you can start your program as easy as
cargo run --release
-
The standard Rust tooling (cargo, rustup) which you can install from https://rustup.rs/
-
Toolchain support for the cortex-m0+ processors in the rp2040 (thumbv6m-none-eabi)
-
flip-link - this allows you to detect stack-overflows on the first core, which is the only supported target for now.
-
probe-run. Upstream support for RP2040 is not finished yet, so this template uses
probe-run-rpfor now.probe-run-rpis a version ofprobe-runusing aprobe-rsfork with support for the RP2040 chip. Note that this installs the binary with nameprobe-run-rp, so you can still have the originalprobe-runinstalled in parallel.This is important because
probe-run-rpONLY works with the RP2040 chip. -
A CMSIS-DAP probe. (JLink probes sort of work but are very unstable. Other probes won't work at all)
You can use a second Pico as a CMSIS-DAP debug probe by installing the following firmware on it: https://github.com/majbthrd/DapperMime/releases/download/20210225/raspberry_pi_pico-DapperMime.uf2
More details on supported debug probes can be found in debug_probes.md
rustup target install thumbv6m-none-eabi
cargo install --git https://github.com/rp-rs/probe-run --branch rp2040-support
cargo install flip-link
For a debug build
cargo run
For a release build
cargo run --release
This project is licensed under either of
-
Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
-
MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.