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 8c7f38f16b
Adjust branch configuration for CI
3 years ago
.cargo First release of stm32f0xx-hal based on stm32f042-hal 4 years ago
.github/workflows Adjust branch configuration for CI 3 years ago
examples Ran rustfmt over all code 3 years ago
src Made I2C more resilient by handling more error conditions (#95) 3 years ago
tools More parametrisation and added section sizes as requested 3 years ago
.gitignore First release of stm32f0xx-hal based on stm32f042-hal 4 years ago
CHANGELOG.md Simplify serial `read()` error handling 3 years ago
Cargo.toml Make cortex-m-rt a dev-dependency only 3 years ago
LICENSE-0BSD.txt Added forgotten LICENSE file 4 years ago
README.md Add link to repository behind CI badge 3 years ago
memory.x Use the smallest available flash& ram size 4 years ago
openocd.cfg First release of stm32f0xx-hal based on stm32f042-hal 4 years ago
openocd_program.sh First release of stm32f0xx-hal based on stm32f042-hal 4 years ago

README.md

stm32f0xx-hal

Continuous integration Crates.io docs.rs

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.