287 lines
7.8 KiB
Rust
287 lines
7.8 KiB
Rust
#![cfg_attr(not(test), no_std)]
|
|
#![allow(async_fn_in_trait)]
|
|
#![warn(missing_docs)]
|
|
|
|
//! ## Feature flags
|
|
#![doc = document_features::document_features!(feature_label = r#"<span class="stab portability"><code>{feature}</code></span>"#)]
|
|
|
|
// This must go FIRST so that all the other modules see its macros.
|
|
mod fmt;
|
|
include!(concat!(env!("OUT_DIR"), "/_macros.rs"));
|
|
|
|
// Utilities
|
|
pub mod time;
|
|
mod traits;
|
|
|
|
// Always-present hardware
|
|
pub mod dma;
|
|
pub mod gpio;
|
|
pub mod rcc;
|
|
#[cfg(feature = "_time-driver")]
|
|
mod time_driver;
|
|
pub mod timer;
|
|
|
|
// Sometimes-present hardware
|
|
|
|
#[cfg(adc)]
|
|
pub mod adc;
|
|
#[cfg(can)]
|
|
pub mod can;
|
|
#[cfg(crc)]
|
|
pub mod crc;
|
|
#[cfg(dac)]
|
|
pub mod dac;
|
|
#[cfg(dcmi)]
|
|
pub mod dcmi;
|
|
#[cfg(eth)]
|
|
pub mod eth;
|
|
#[cfg(feature = "exti")]
|
|
pub mod exti;
|
|
pub mod flash;
|
|
#[cfg(fmc)]
|
|
pub mod fmc;
|
|
#[cfg(hrtim)]
|
|
pub mod hrtim;
|
|
#[cfg(i2c)]
|
|
pub mod i2c;
|
|
#[cfg(all(spi_v1, rcc_f4))]
|
|
pub mod i2s;
|
|
#[cfg(stm32wb)]
|
|
pub mod ipcc;
|
|
#[cfg(feature = "low-power")]
|
|
pub mod low_power;
|
|
#[cfg(opamp)]
|
|
pub mod opamp;
|
|
#[cfg(quadspi)]
|
|
pub mod qspi;
|
|
#[cfg(rng)]
|
|
pub mod rng;
|
|
#[cfg(all(rtc, not(rtc_v1)))]
|
|
pub mod rtc;
|
|
#[cfg(sai)]
|
|
pub mod sai;
|
|
#[cfg(sdmmc)]
|
|
pub mod sdmmc;
|
|
#[cfg(spi)]
|
|
pub mod spi;
|
|
#[cfg(uid)]
|
|
pub mod uid;
|
|
#[cfg(usart)]
|
|
pub mod usart;
|
|
#[cfg(usb)]
|
|
pub mod usb;
|
|
#[cfg(otg)]
|
|
pub mod usb_otg;
|
|
#[cfg(iwdg)]
|
|
pub mod wdg;
|
|
|
|
// This must go last, so that it sees all the impl_foo! macros defined earlier.
|
|
pub(crate) mod _generated {
|
|
#![allow(dead_code)]
|
|
#![allow(unused_imports)]
|
|
#![allow(non_snake_case)]
|
|
#![allow(missing_docs)]
|
|
|
|
include!(concat!(env!("OUT_DIR"), "/_generated.rs"));
|
|
}
|
|
|
|
pub use crate::_generated::interrupt;
|
|
|
|
/// Macro to bind interrupts to handlers.
|
|
///
|
|
/// This defines the right interrupt handlers, and creates a unit struct (like `struct Irqs;`)
|
|
/// and implements the right [`Binding`]s for it. You can pass this struct to drivers to
|
|
/// prove at compile-time that the right interrupts have been bound.
|
|
///
|
|
/// Example of how to bind one interrupt:
|
|
///
|
|
/// ```rust,ignore
|
|
/// use embassy_stm32::{bind_interrupts, usb_otg, peripherals};
|
|
///
|
|
/// bind_interrupts!(struct Irqs {
|
|
/// OTG_FS => usb_otg::InterruptHandler<peripherals::USB_OTG_FS>;
|
|
/// });
|
|
/// ```
|
|
///
|
|
/// Example of how to bind multiple interrupts, and multiple handlers to each interrupt, in a single macro invocation:
|
|
///
|
|
/// ```rust,ignore
|
|
/// use embassy_stm32::{bind_interrupts, i2c, peripherals};
|
|
///
|
|
/// bind_interrupts!(struct Irqs {
|
|
/// I2C1 => i2c::EventInterruptHandler<peripherals::I2C1>, i2c::ErrorInterruptHandler<peripherals::I2C1>;
|
|
/// I2C2_3 => i2c::EventInterruptHandler<peripherals::I2C2>, i2c::ErrorInterruptHandler<peripherals::I2C2>,
|
|
/// i2c::EventInterruptHandler<peripherals::I2C3>, i2c::ErrorInterruptHandler<peripherals::I2C3>;
|
|
/// });
|
|
/// ```
|
|
|
|
// developer note: this macro can't be in `embassy-hal-internal` due to the use of `$crate`.
|
|
#[macro_export]
|
|
macro_rules! bind_interrupts {
|
|
($vis:vis struct $name:ident { $($irq:ident => $($handler:ty),*;)* }) => {
|
|
#[derive(Copy, Clone)]
|
|
$vis struct $name;
|
|
|
|
$(
|
|
#[allow(non_snake_case)]
|
|
#[no_mangle]
|
|
unsafe extern "C" fn $irq() {
|
|
$(
|
|
<$handler as $crate::interrupt::typelevel::Handler<$crate::interrupt::typelevel::$irq>>::on_interrupt();
|
|
)*
|
|
}
|
|
|
|
$(
|
|
unsafe impl $crate::interrupt::typelevel::Binding<$crate::interrupt::typelevel::$irq, $handler> for $name {}
|
|
)*
|
|
)*
|
|
};
|
|
}
|
|
|
|
// Reexports
|
|
pub use _generated::{peripherals, Peripherals};
|
|
pub use embassy_hal_internal::{into_ref, Peripheral, PeripheralRef};
|
|
#[cfg(feature = "unstable-pac")]
|
|
pub use stm32_metapac as pac;
|
|
#[cfg(not(feature = "unstable-pac"))]
|
|
pub(crate) use stm32_metapac as pac;
|
|
|
|
use crate::interrupt::Priority;
|
|
#[cfg(feature = "rt")]
|
|
pub use crate::pac::NVIC_PRIO_BITS;
|
|
use crate::rcc::sealed::RccPeripheral;
|
|
|
|
/// `embassy-stm32` global configuration.
|
|
#[non_exhaustive]
|
|
pub struct Config {
|
|
/// RCC config.
|
|
pub rcc: rcc::Config,
|
|
|
|
/// Enable debug during sleep.
|
|
///
|
|
/// May incrase power consumption. Defaults to true.
|
|
#[cfg(dbgmcu)]
|
|
pub enable_debug_during_sleep: bool,
|
|
|
|
/// BDMA interrupt priority.
|
|
///
|
|
/// Defaults to P0 (highest).
|
|
#[cfg(bdma)]
|
|
pub bdma_interrupt_priority: Priority,
|
|
|
|
/// DMA interrupt priority.
|
|
///
|
|
/// Defaults to P0 (highest).
|
|
#[cfg(dma)]
|
|
pub dma_interrupt_priority: Priority,
|
|
|
|
/// GPDMA interrupt priority.
|
|
///
|
|
/// Defaults to P0 (highest).
|
|
#[cfg(gpdma)]
|
|
pub gpdma_interrupt_priority: Priority,
|
|
}
|
|
|
|
impl Default for Config {
|
|
fn default() -> Self {
|
|
Self {
|
|
rcc: Default::default(),
|
|
#[cfg(dbgmcu)]
|
|
enable_debug_during_sleep: true,
|
|
#[cfg(bdma)]
|
|
bdma_interrupt_priority: Priority::P0,
|
|
#[cfg(dma)]
|
|
dma_interrupt_priority: Priority::P0,
|
|
#[cfg(gpdma)]
|
|
gpdma_interrupt_priority: Priority::P0,
|
|
}
|
|
}
|
|
}
|
|
|
|
/// Initialize the `embassy-stm32` HAL with the provided configuration.
|
|
///
|
|
/// This returns the peripheral singletons that can be used for creating drivers.
|
|
///
|
|
/// This should only be called once at startup, otherwise it panics.
|
|
pub fn init(config: Config) -> Peripherals {
|
|
critical_section::with(|cs| {
|
|
let p = Peripherals::take_with_cs(cs);
|
|
|
|
#[cfg(dbgmcu)]
|
|
if config.enable_debug_during_sleep {
|
|
crate::pac::DBGMCU.cr().modify(|cr| {
|
|
#[cfg(any(dbgmcu_f0, dbgmcu_c0, dbgmcu_g0, dbgmcu_u5, dbgmcu_wba))]
|
|
{
|
|
cr.set_dbg_stop(true);
|
|
cr.set_dbg_standby(true);
|
|
}
|
|
#[cfg(any(
|
|
dbgmcu_f1, dbgmcu_f2, dbgmcu_f3, dbgmcu_f4, dbgmcu_f7, dbgmcu_g4, dbgmcu_f7, dbgmcu_l0, dbgmcu_l1,
|
|
dbgmcu_l4, dbgmcu_wb, dbgmcu_wl
|
|
))]
|
|
{
|
|
cr.set_dbg_sleep(true);
|
|
cr.set_dbg_stop(true);
|
|
cr.set_dbg_standby(true);
|
|
}
|
|
#[cfg(dbgmcu_h7)]
|
|
{
|
|
cr.set_d1dbgcken(true);
|
|
cr.set_d3dbgcken(true);
|
|
cr.set_dbgsleep_d1(true);
|
|
cr.set_dbgstby_d1(true);
|
|
cr.set_dbgstop_d1(true);
|
|
}
|
|
});
|
|
}
|
|
|
|
#[cfg(not(any(stm32f1, stm32wb, stm32wl)))]
|
|
peripherals::SYSCFG::enable_and_reset_with_cs(cs);
|
|
#[cfg(not(any(stm32h5, stm32h7, stm32wb, stm32wl)))]
|
|
peripherals::PWR::enable_and_reset_with_cs(cs);
|
|
#[cfg(not(any(stm32f2, stm32f4, stm32f7, stm32l0, stm32h5, stm32h7)))]
|
|
peripherals::FLASH::enable_and_reset_with_cs(cs);
|
|
|
|
unsafe {
|
|
#[cfg(feature = "_split-pins-enabled")]
|
|
crate::pac::SYSCFG.pmcr().modify(|pmcr| {
|
|
#[cfg(feature = "split-pa0")]
|
|
pmcr.set_pa0so(true);
|
|
#[cfg(feature = "split-pa1")]
|
|
pmcr.set_pa1so(true);
|
|
#[cfg(feature = "split-pc2")]
|
|
pmcr.set_pc2so(true);
|
|
#[cfg(feature = "split-pc3")]
|
|
pmcr.set_pc3so(true);
|
|
});
|
|
|
|
gpio::init(cs);
|
|
dma::init(
|
|
cs,
|
|
#[cfg(bdma)]
|
|
config.bdma_interrupt_priority,
|
|
#[cfg(dma)]
|
|
config.dma_interrupt_priority,
|
|
#[cfg(gpdma)]
|
|
config.gpdma_interrupt_priority,
|
|
);
|
|
#[cfg(feature = "exti")]
|
|
exti::init(cs);
|
|
|
|
rcc::init(config.rcc);
|
|
|
|
// must be after rcc init
|
|
#[cfg(feature = "_time-driver")]
|
|
time_driver::init(cs);
|
|
|
|
#[cfg(feature = "low-power")]
|
|
{
|
|
crate::rcc::REFCOUNT_STOP2 = 0;
|
|
crate::rcc::REFCOUNT_STOP1 = 0;
|
|
}
|
|
}
|
|
|
|
p
|
|
})
|
|
}
|