Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/stm32-rs/stm32wlxx-hal
A Hardware abstraction layer for the stm32wl series chips written in rust.
https://github.com/stm32-rs/stm32wlxx-hal
embedded hal rust stm32wl
Last synced: 23 minutes ago
JSON representation
A Hardware abstraction layer for the stm32wl series chips written in rust.
- Host: GitHub
- URL: https://github.com/stm32-rs/stm32wlxx-hal
- Owner: stm32-rs
- License: apache-2.0
- Created: 2021-04-18T22:01:54.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-09-06T03:35:26.000Z (4 months ago)
- Last Synced: 2025-01-11T04:42:44.503Z (7 days ago)
- Topics: embedded, hal, rust, stm32wl
- Language: Rust
- Homepage:
- Size: 1.07 MB
- Stars: 47
- Watchers: 5
- Forks: 18
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
# stm32wlxx-hal
[](https://github.com/stm32-rs/stm32wlxx-hal/actions?query=branch%3Amain)
[](https://docs.rs/stm32wlxx-hal/)
[](https://stm32-rs.github.io/stm32wlxx-hal/stm32wlxx_hal/index.html)
[](https://crates.io/crates/stm32wlxx-hal)
[](https://doc.rust-lang.org/cargo/reference/manifest.html#the-rust-version-field)
Embedded rust HAL (hardware abstraction layer) for the STM32WL series.
This is still in development, the code that exists today covers basic usage of:
* SubGHz LoRa TX + RX
* SubGHz (G)FSK TX + RX
* SPI
* GPIO
* UART
* I2C
* Low-power timers
* ADC
* DAC
* PKA ECDSA signing + verification
* Secure random number generation
* AES ECB encryption + decryption
* RTC date and time
## Usage
```toml
[dependencies.stm32wlxx-hal]
version = "0.6.1"
features = [
# use exactly one to match your target hardware
"stm32wl5x_cm0p",
"stm32wl5x_cm4",
"stm32wle5",
# optional: use the cortex-m-rt interrupt interface
"rt",
# optional: use defmt
"defmt",
# optional: enable conversions with embedded-time types
"embedded-time",
# optional: use the real time clock (RTC)
"chrono",
]
```
## Examples
All examples run on the NUCLEO-WL55JC2.
Most examples are written in the form of on-target tests. See [testsuite/README.md](https://github.com/stm32-rs/stm32wlxx-hal/blob/main/testsuite/README.md) for details.
There are also simple examples located in the `examples` crate. These can be run with the `run-ex` cargo alias:
```bash
cargo run-ex gpio-blink
```
### System Level Example
The on-target tests and examples are a good starting point, but they demonstrate features independent of each-other. A system-level example using multiple features simultaneously is provided in a separate repo: [stm32wl-lightswitch-demo](https://github.com/newAM/stm32wl-lightswitch-demo)
## Unit Tests
Off-target unit tests use the built-in cargo framework. You must specify the target device as a feature.
```bash
cargo test --features stm32wl5x_cm4
```
## Reference Documentation
* [stm32wl5x reference manual](https://www.st.com/resource/en/reference_manual/rm0453-stm32wl5x-advanced-armbased-32bit-mcus-with-subghz-radio-solution-stmicroelectronics.pdf)
* [stm32wlex reference manual](https://www.st.com/resource/en/reference_manual/rm0461-stm32wlex-advanced-armbased-32bit-mcus-with-subghz-radio-solution-stmicroelectronics.pdf)
* [stm32wl55cc datasheet](https://www.st.com/resource/en/datasheet/stm32wl55cc.pdf)
* [stm32wle5c8 datasheet](https://www.st.com/resource/en/datasheet/stm32wle5c8.pdf)
* [stm32wl55xx stm32wl54xx erratum](https://www.st.com/resource/en/errata_sheet/es0500-stm32wl55xx-stm32wl54xx-device-errata-stmicroelectronics.pdf)
* [stm32wle5xx stm32wle4xx erratum](https://www.st.com/resource/en/errata_sheet/es0506-stm32wle5xx-stm32wle4xx-device-errata-stmicroelectronics.pdf)