`Rust support for RP2040 microcontrollers`

This repository contains peripheral access crates (PAC), hardware abstraction layers (HAL) and board support packages for the RP2040 and related microcontroller and boards using it, like the Raspberry Pi Pico.

Related projects

There is a similar project called rp-rs which currently contains more code than this one. As both are under development and far away from a stable release, please have a look at both and pick whatever you like.

Prerequisites

The Rasperry Pi Pico contains a microcontroller using the Arm architecture. To cross-compile for that architecture, the matching target needs to be installed:

rustup target add thumbv6m-none-eabi

Repository structure

The structure is modelled after the repository for atsamd.

This assumes that the RP2040 will be accompanied by a family of relatec microcontrolles. (See chapter "Why is the chip called RP2040?" in the RP2040 datasheet).

Current state / TODO

Currently, there is a PAC generated from the SVD file, a minimal board support crate and a stub HAL.

The goal is to first get a working firmware which can be uploaded to the Raspberry Pi Pico, and then implement the embedded-hal interface.

For now, a simple blinky example can be compiled. It is completely untested, as I do not yet have access to the hardware.

A TODO list can be found in the wiki.

Usage

An example blinking a LED can be compiled with:

cd boards/rp-pico
cargo build --target thumbv6m-none-eabi --example=blink  --release

To re-generate the rust source code from svd files, some tools are necessary. Once they are installed, use generate.sh to call svd2rust and format the source code using form.

cargo install svd2rust
cargo install form
sh generate.sh

On how to setup on chip debugging please check out ON-CHIP_DEBUGGING.md

License

The rest of this repository is licensed under the terms of both the MIT license and the Apache License (Version 2.0), at your option.

Parts of this code was copied from rp-rs, which is published under the same license.

dexw25/rp-microcontroller-rs

Rust support for RP2040 microcontrollers