drone-stm32-map

STM32 peripheral mappings for Drone, an Embedded Operating System.

This crate uses CMSIS-SVD files provided by STMicroelectronics to automatically generate Drone register and interrupt bindings. However only the corresponding Reference Manual is the single source of truth. A difference between this crate bindings and the Reference Manual is considered a bug. Fixing such a bug is not a breaking change.

This crate re-exports the contents of [drone_cortex_m::map] module and is a drop-in replacement for it.

Supported Devices

| Device name / Cargo feature | Core name | Reference manual | |-------------|-----------------------|--------------------------------------------------------------------------| | stm32f100 | ARM® Cortex®-M3 r1p1 | RM0041 | | stm32f101 | ARM® Cortex®-M3 r1p1 | RM0008 | | stm32f102 | ARM® Cortex®-M3 r1p1 | RM0008 | | stm32f103 | ARM® Cortex®-M3 r1p1 | RM0008 | | stm32f107 | ARM® Cortex®-M3 r1p1 | RM0008 | | stm32l4x1 | ARM® Cortex®-M4F r0p1 | RM0394 | | stm32l4x2 | ARM® Cortex®-M4F r0p1 | RM0394 | | stm32l4x3 | ARM® Cortex®-M4F r0p1 | RM0394 | | stm32l4x5 | ARM® Cortex®-M4F r0p1 | RM0351 | | stm32l4x6 | ARM® Cortex®-M4F r0p1 | RM0351 | | stm32l4r5 | ARM® Cortex®-M4F r0p1 | RM0432 | | stm32l4s5 | ARM® Cortex®-M4F r0p1 | RM0432 | | stm32l4r7 | ARM® Cortex®-M4F r0p1 | RM0432 | | stm32l4s7 | ARM® Cortex®-M4F r0p1 | RM0432 | | stm32l4r9 | ARM® Cortex®-M4F r0p1 | RM0432 | | stm32l4s9 | ARM® Cortex®-M4F r0p1 | RM0432 |

NOTE Exactly one cargo feature should be selected based on the device model.

Documentation

• Drone Book
• API documentation

The API documentation intentionally skips auto-generated [reg] and [thr] bindings. Otherwise it would use several gigabytes of space and would be very slow to render in a browser. One should refer to the Reference Manual instead. And to get an idea of what the API looks like on the Drone side, look at the [drone_cortex_m::map] module documentation.

Usage

Place the following to the Cargo.toml:

toml [dependencies] drone-stm32-map = { version = "0.10.1", features = [...] }

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.

Contribution

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.