stm32wlxx-hal

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. Examples are located in the examples crate. The arguments got long for this, so a run-ex cargo alias is provided.

bash DEFMT_LOG=trace cargo run-ex gpio-blink

The on-target tests are also excellent reference material.

System Level Example

The testsuites 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

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

On-Target Tests

See testsuite/README.md.