stm32f3xx-hal
stm32f3xx-hal
contains a multi device hardware abstraction on top of the
peripheral access API for the STMicro STM32F3 series microcontrollers. The
selection of the MCU is done by feature gates, typically specified by board
support crates. An excerpt of supported chip variants:
- stm32f301
- stm32f318
- stm32f302
- stm32f303
- stm32f373
- stm32f378
- stm32f334
- stm32f328
- stm32f358
- stm32f398
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.
Collaboration on this crate is highly welcome as are pull requests!
This crate relies on Adam Greigs fantastic stm32f3
crate to provide
appropriate register definitions and implements a partial set of the
embedded-hal
traits.
Almost all of the implementation was shamelessly adapted from the
stm32f30x-hal
crate by Jorge Aparicio.
Getting Started
Adding stm32f3xx-hal and other dependencies
Cargo.toml:
[dependencies]
# Only set the critical section feature, if you are using a bare-metal platform
# without any RTOS
# See https://github.com/rust-embedded/critical-section for further details.
cortex-m = { version = "0.7.4", features = ["critical-section-single-core"]}
cortex-m-rt = { version = "0.7.3", features = ["device"] }
# Panic behavior, see https://crates.io/keywords/panic-impl for alternatives
panic-halt = "0.2.0"
# Replace stm32f303xc with your target chip, see next section for more info
stm32f3xx-hal = { version = "0.9.2", features = ["ld", "rt", "stm32f303xc"] }
We also need to tell Rust about target architecture and how to link our
executable by creating .cargo/config
.
.cargo/config:
[target.thumbv7em-none-eabihf]
rustflags = [
"-C", "link-arg=-Tlink.x",
]
[build]
target = "thumbv7em-none-eabihf"
Selecting the right chip
This crate requires you to specify your target chip as a feature.
Example: The STM32F3Discovery board has a STM32F303VCT6 chip according to the
user manual. So you need to specify stm32f303xc
in your Cargo.toml
(note that VC → xc).
All possible chip variants are selectable via cargo features. You can find a list here, in the docs.
Note
- This features are mutually exclusive. Only one feature / chip variant can be chosen.
- You have to choose exactly one feature to build this crate at all.
Background
For some of the stm32f3xx chips there are sub-variants that differ in functionality, peripheral use and hence 'under the hood' implementation. To allow the full use of all peripherals on certain sub-variants without allowing for code that just doesn't run on other sub-variants, they are distinct features that need to be specified.
Basic Usage
#![no_std]
#![no_main]
use cortex_m::asm;
use cortex_m_rt::entry;
use panic_halt as _;
use stm32f3xx_hal::{self as hal, pac, prelude::*};
#[entry]
fn main() -> ! {
let dp = pac::Peripherals::take().unwrap();
let mut rcc = dp.RCC.constrain();
let mut gpioe = dp.GPIOE.split(&mut rcc.ahb);
let mut led = gpioe
.pe13
.into_push_pull_output(&mut gpioe.moder, &mut gpioe.otyper);
loop {
led.toggle().unwrap();
asm::delay(8_000_000);
}
}
See the examples folder for more example programs.
Changelog
Minimum Supported Rust Version (MSRV)
This crate is guaranteed to compile on stable Rust 1.59.0 and up. It might compile with older versions but that may change in any new patch release.
Contributing
License
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.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.