stm32wlxx-hal

Crates.iostm32wlxx-hal
lib.rsstm32wlxx-hal
version0.6.1
sourcesrc
created_at2021-03-26 15:28:00.606241
updated_at2022-08-01 21:04:05.230868
descriptionHardware abstraction layer for the STM32WL series microcontrollers.
homepage
repositoryhttps://github.com/stm32-rs/stm32wlxx-hal
max_upload_size
id373848
size739,125
stm32wl (github:stm32-rs:stm32wl)

documentation

README

stm32wlxx-hal

CI stable-docs nightly-docs crates.io rustc

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

[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.

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.

cargo test --features stm32wl5x_cm4

On-Target Tests

See testsuite/README.md.

Reference Documentation

Commit count: 339

cargo fmt