1 unstable release
0.1.0 | Jun 27, 2024 |
---|
#929 in Embedded development
Used in aemics_stm32g4xx_drivers
640KB
15K
SLoC
STM32G4xx Hardware Abstraction Layer
This project contains the hardware abstraction layer used by the PYglet and PYg Mud Puddle Board Abstraction Layers. It can also be used independently to program MCUs of the STM32G4 family.
The HAL implements the embedded-hal crate which outlines a generic API to follow for Rust HAL projects.
This HAL uses the stm32g4 device support crate to interact with the MCU's registers.
The HAL was based off of the stm32g4xx-hal crate and updated to embedded-hal v1.0.0.
Currently, the only verified supported device is the STM32G473.
Setup
prerequisites:
1. WINDOWS: C++ build tools for Visual Studio 2019.
install rustup
go to https://www.rust-lang.org/tools/install
download and run installer.
select standard installation
check if installed by running rustc -V
Should say "rustc 1.78.0" or greater.
Note: In case of an existing installation, try running: rustup update
set up tooling
run rustup target add thumbv7em-none-eabihf
cargo install cargo-binutils
rustup component add llvm-tools
set up stm32cubeprog
https://www.st.com/en/development-tools/stm32cubeprog.html
run installer, standard settings. Make a note of the installation folder.
Add the installation's 'bin' folder to your PATH environment variable.
Restart your pc
Note: At time of writing, the stm32cubeprogrammer installer does not support Wayland display driver.
If this issue comes up, instead try using dfu-util.
Usage
To add this HAL to your project, add the following line to your project's Cargo.toml file:
[dependencies]
aemics-stm32g4xx-hal = { git = "https://gitlab.aemics.nl/aepym/30023200.git", features = ["rt","stm32g473"]}
It is also possible to use the crates.io name, which when set up (to do as of 27-06-2024) should look like:
[dependencies]
aemics-stm32g4xx-hal = "0.1.0"
The /examples/ folder contains many examples which set up simple programs such as a blinky test program or I2C communication to use when getting started.
Known Issues
- The USB implementation only functions in (optimized) release builds.
Version History
- 20-03-2024: Version 0.0.0 Initial version of the project, implementing only embedded-hal v0.2.7.
- 27-06-2024: 0.1.0 Implementing both embedded-hal v1.0.0 and v0.2.7. USB support added
Dependencies
~51MB
~1.5M SLoC