marc

stm32f0xx-hal

You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

Go to file

Daniel Egger 2ba2f8c413 Use GH actions badge for CI		3 years ago
.cargo	First release of stm32f0xx-hal based on stm32f042-hal	5 years ago
.github/workflows	Use GH actions for CI	3 years ago
examples	Ran rustfmt over all code	3 years ago
src	Fix clippy lints	3 years ago
tools	More parametrisation and added section sizes as requested	4 years ago
.gitignore	First release of stm32f0xx-hal based on stm32f042-hal	5 years ago
CHANGELOG.md	Simplify serial `read()` error handling	4 years ago
Cargo.toml	Add thumbv6m-none-eabi target to docs.	4 years ago
LICENSE-0BSD.txt	Added forgotten LICENSE file	5 years ago
README.md	Use GH actions badge for CI	3 years ago
memory.x	Use the smallest available flash& ram size	5 years ago
openocd.cfg	First release of stm32f0xx-hal based on stm32f042-hal	5 years ago
openocd_program.sh	First release of stm32f0xx-hal based on stm32f042-hal	5 years ago

README.md

stm32f0xx-hal

[

stm32f0xx-hal contains a hardware abstraction on top of the peripheral access API for the STMicro STM32F0xx family of microcontrollers.

This crate replaces the stm32f042-hal by a more ubiquitous version suitable for additional families. The idea behind this crate is to gloss over the slight differences in the various peripherals available on those MCUs so a HAL can be written for all chips in that same family without having to cut and paste crates for every single model.

This crate relies on Adam Greig's fantastic stm32f0 crate to provide appropriate register definitions, and implements a partial set of the embedded-hal traits. Some of the implementation was shamelessly adapted from the stm32f103xx-hal crate by Jorge Aparicio.

Collaboration on this crate is highly welcome, as are pull requests!

Supported Configurations

stm32f030 (stm32f030x4, stm32f030x6, stm32f030x8, stm32f030xc)
stm32f031
stm32f038
stm32f042
stm32f048
stm32f051
stm32f058
stm32f070 (stm32f070x6, stm32f070xb)
stm32f071
stm32f072
stm32f078
stm32f091
stm32f098

Getting Started

The examples folder contains several example programs. To compile them, one must specify the target device as cargo feature:

$ cargo build --features=stm32f030

To use stm32f0xx-hal as a dependency in a standalone project the target device feature must be specified in the Cargo.toml file:

[dependencies]
cortex-m = "0.6.0"
cortex-m-rt = "0.6.8"
stm32f0xx-hal = {version = "0.16", features = ["stm32f030"]}

If you are unfamiliar with embedded development using Rust, there are a number of fantastic resources available to help.

Minimum supported Rust version

The minimum supported Rust version at the moment is 1.39.0. Older versions may compile, especially when some features are not used in your application.

Changelog

See CHANGELOG.md.

License

0-Clause BSD License, see LICENSE-0BSD.txt for more details.