#[cfg(rcc_f3)] use crate::pac::adccommon::vals::Ckmode; use crate::pac::flash::vals::Latency; pub use crate::pac::rcc::vals::Adcpres; use crate::pac::rcc::vals::{Hpre, Pllmul, Pllsrc, Ppre, Prediv, Sw, Usbpre}; use crate::pac::{FLASH, RCC}; use crate::rcc::{set_freqs, Clocks}; use crate::time::Hertz; /// HSI speed pub const HSI_FREQ: Hertz = Hertz(8_000_000); #[cfg(rcc_f3)] impl From for Ckmode { fn from(value: AdcClockSource) -> Self { match value { AdcClockSource::BusDiv1 => Ckmode::SYNCDIV1, AdcClockSource::BusDiv2 => Ckmode::SYNCDIV2, AdcClockSource::BusDiv4 => Ckmode::SYNCDIV4, _ => unreachable!(), } } } #[derive(Clone, Copy)] pub enum AdcClockSource { Pll(Adcpres), BusDiv1, BusDiv2, BusDiv4, } impl AdcClockSource { pub fn bus_div(&self) -> u32 { match self { Self::BusDiv1 => 1, Self::BusDiv2 => 2, Self::BusDiv4 => 4, _ => unreachable!(), } } } #[derive(Default)] pub enum HrtimClockSource { #[default] BusClk, PllClk, } /// Clocks configutation #[non_exhaustive] #[derive(Default)] pub struct Config { /// Frequency of HSE oscillator /// 4MHz to 32MHz pub hse: Option, /// Bypass HSE for an external clock pub bypass_hse: bool, /// Frequency of the System Clock pub sysclk: Option, /// Frequency of AHB bus pub hclk: Option, /// Frequency of APB1 bus /// - Max frequency 36MHz pub pclk1: Option, /// Frequency of APB2 bus /// - Max frequency with HSE is 72MHz /// - Max frequency without HSE is 64MHz pub pclk2: Option, /// USB clock setup /// It is valid only when, /// - HSE is enabled, /// - The System clock frequency is either 48MHz or 72MHz /// - APB1 clock has a minimum frequency of 10MHz pub pll48: bool, #[cfg(rcc_f3)] /// ADC clock setup /// - For AHB, a psc of 4 or less must be used pub adc: Option, #[cfg(rcc_f3)] /// ADC clock setup /// - For AHB, a psc of 4 or less must be used pub adc34: Option, #[cfg(stm32f334)] pub hrtim: HrtimClockSource, pub ls: super::LsConfig, } // Information required to setup the PLL clock #[derive(Clone, Copy)] struct PllConfig { pll_src: Pllsrc, pll_mul: Pllmul, pll_div: Option, } /// Initialize and Set the clock frequencies pub(crate) unsafe fn init(config: Config) { // Calculate the real System clock, and PLL configuration if applicable let (sysclk, pll_config) = get_sysclk(&config); assert!(sysclk.0 <= 72_000_000); // Calculate real AHB clock let hclk = config.hclk.map(|h| h).unwrap_or(sysclk); let hpre = match sysclk.0 / hclk.0 { 0 => unreachable!(), 1 => Hpre::DIV1, 2 => Hpre::DIV2, 3..=5 => Hpre::DIV4, 6..=11 => Hpre::DIV8, 12..=39 => Hpre::DIV16, 40..=95 => Hpre::DIV64, 96..=191 => Hpre::DIV128, 192..=383 => Hpre::DIV256, _ => Hpre::DIV512, }; let hclk = sysclk / hpre; assert!(hclk <= Hertz(72_000_000)); // Calculate real APB1 clock let pclk1 = config.pclk1.unwrap_or(hclk); let ppre1 = match hclk / pclk1 { 0 => unreachable!(), 1 => Ppre::DIV1, 2 => Ppre::DIV2, 3..=5 => Ppre::DIV4, 6..=11 => Ppre::DIV8, _ => Ppre::DIV16, }; let timer_mul1 = if ppre1 == Ppre::DIV1 { 1u32 } else { 2 }; let pclk1 = hclk / ppre1; assert!(pclk1 <= Hertz(36_000_000)); // Calculate real APB2 clock let pclk2 = config.pclk2.unwrap_or(hclk); let ppre2 = match hclk / pclk2 { 0 => unreachable!(), 1 => Ppre::DIV1, 2 => Ppre::DIV2, 3..=5 => Ppre::DIV4, 6..=11 => Ppre::DIV8, _ => Ppre::DIV16, }; let timer_mul2 = if ppre2 == Ppre::DIV1 { 1u32 } else { 2 }; let pclk2 = hclk / ppre2; assert!(pclk2 <= Hertz(72_000_000)); // Set latency based on HCLK frquency // RM0316: "The prefetch buffer must be kept on when using a prescaler // different from 1 on the AHB clock.", "Half-cycle access cannot be // used when there is a prescaler different from 1 on the AHB clock" FLASH.acr().modify(|w| { w.set_latency(if hclk <= Hertz(24_000_000) { Latency::WS0 } else if hclk <= Hertz(48_000_000) { Latency::WS1 } else { Latency::WS2 }); if hpre != Hpre::DIV1 { w.set_hlfcya(false); w.set_prftbe(true); } }); // Enable HSE // RM0316: "Bits 31:26 Reserved, must be kept at reset value." if config.hse.is_some() { RCC.cr().modify(|w| { w.set_hsebyp(config.bypass_hse); // We turn on clock security to switch to HSI when HSE fails w.set_csson(true); w.set_hseon(true); }); while !RCC.cr().read().hserdy() {} } // Enable PLL // RM0316: "Reserved, must be kept at reset value." if let Some(ref pll_config) = pll_config { RCC.cfgr().modify(|w| { w.set_pllmul(pll_config.pll_mul); w.set_pllsrc(pll_config.pll_src); }); if let Some(pll_div) = pll_config.pll_div { RCC.cfgr2().modify(|w| w.set_prediv(pll_div)); } RCC.cr().modify(|w| w.set_pllon(true)); while !RCC.cr().read().pllrdy() {} } // CFGR has been written before (PLL) don't overwrite these settings if config.pll48 { let usb_pre = get_usb_pre(&config, sysclk, pclk1, &pll_config); RCC.cfgr().modify(|w| { w.set_usbpre(usb_pre); }); } // Set prescalers // CFGR has been written before (PLL, PLL48) don't overwrite these settings RCC.cfgr().modify(|w| { w.set_ppre2(ppre2); w.set_ppre1(ppre1); w.set_hpre(hpre); }); // Wait for the new prescalers to kick in // "The clocks are divided with the new prescaler factor from // 1 to 16 AHB cycles after write" cortex_m::asm::delay(16); // CFGR has been written before (PLL, PLL48, clock divider) don't overwrite these settings RCC.cfgr().modify(|w| { w.set_sw(match (pll_config, config.hse) { (Some(_), _) => Sw::PLL, (None, Some(_)) => Sw::HSE, (None, None) => Sw::HSI, }) }); #[cfg(rcc_f3)] let adc = config.adc.map(|adc| match adc { AdcClockSource::Pll(adcpres) => { RCC.cfgr2().modify(|w| { // Make sure that we're using the PLL pll_config.unwrap(); w.set_adc12pres(adcpres); sysclk / adcpres }) } _ => crate::pac::ADC_COMMON.ccr().modify(|w| { assert!(!(adc.bus_div() == 1 && hpre != Hpre::DIV1)); w.set_ckmode(adc.into()); sysclk / adc.bus_div() }), }); #[cfg(all(rcc_f3, adc3_common))] let adc34 = config.adc34.map(|adc| match adc { AdcClockSource::Pll(adcpres) => { RCC.cfgr2().modify(|w| { // Make sure that we're using the PLL pll_config.unwrap(); w.set_adc34pres(adcpres); sysclk / adcpres }) } _ => crate::pac::ADC_COMMON.ccr().modify(|w| { assert!(!(adc.bus_div() == 1 && hpre != Hpre::DIV1)); w.set_ckmode(adc.into()); sysclk / adc.bus_div() }), }); #[cfg(stm32f334)] let hrtim = match config.hrtim { // Must be configured after the bus is ready, otherwise it won't work HrtimClockSource::BusClk => None, HrtimClockSource::PllClk => { use crate::pac::rcc::vals::Timsw; // Make sure that we're using the PLL pll_config.unwrap(); assert!((pclk2 == sysclk) || (pclk2 * 2u32 == sysclk)); RCC.cfgr3().modify(|w| w.set_hrtim1sw(Timsw::PLL)); Some(sysclk * 2u32) } }; let rtc = config.ls.init(); set_freqs(Clocks { sys: sysclk, apb1: pclk1, apb2: pclk2, apb1_tim: pclk1 * timer_mul1, apb2_tim: pclk2 * timer_mul2, ahb1: hclk, #[cfg(rcc_f3)] adc: adc, #[cfg(all(rcc_f3, adc3_common))] adc34: adc34, #[cfg(all(rcc_f3, not(adc3_common)))] adc34: None, #[cfg(stm32f334)] hrtim: hrtim, rtc, }); } #[inline] fn get_sysclk(config: &Config) -> (Hertz, Option) { match (config.sysclk, config.hse) { (Some(sysclk), Some(hse)) if sysclk == hse => (hse, None), (Some(sysclk), None) if sysclk == HSI_FREQ => (HSI_FREQ, None), // If the user selected System clock is different from HSI or HSE // we will have to setup PLL clock source (Some(sysclk), _) => { let (sysclk, pll_config) = calc_pll(config, sysclk); (sysclk, Some(pll_config)) } (None, Some(hse)) => (hse, None), (None, None) => (HSI_FREQ, None), } } #[inline] fn calc_pll(config: &Config, Hertz(sysclk): Hertz) -> (Hertz, PllConfig) { // Calculates the Multiplier and the Divisor to arrive at // the required System clock from PLL source frequency let get_mul_div = |sysclk, pllsrcclk| { let bus_div = gcd(sysclk, pllsrcclk); let mut multiplier = sysclk / bus_div; let mut divisor = pllsrcclk / bus_div; // Minimum PLL multiplier is two if multiplier == 1 { multiplier *= 2; divisor *= 2; } assert!(multiplier <= 16); assert!(divisor <= 16); (multiplier, divisor) }; // Based on the source of Pll, we calculate the actual system clock // frequency, PLL's source identifier, multiplier and divisor let (act_sysclk, pll_src, pll_mul, pll_div) = match config.hse { Some(Hertz(hse)) => { let (multiplier, divisor) = get_mul_div(sysclk, hse); ( Hertz((hse / divisor) * multiplier), Pllsrc::HSE_DIV_PREDIV, into_pll_mul(multiplier), Some(into_pre_div(divisor)), ) } None => { cfg_if::cfg_if! { // For some chips PREDIV is always two, and cannot be changed if #[cfg(any( stm32f302xd, stm32f302xe, stm32f303xd, stm32f303xe, stm32f398xe ))] { let (multiplier, divisor) = get_mul_div(sysclk, HSI_FREQ.0); ( Hertz((HSI_FREQ.0 / divisor) * multiplier), Pllsrc::HSI_DIV_PREDIV, into_pll_mul(multiplier), Some(into_pre_div(divisor)), ) } else { let pllsrcclk = HSI_FREQ.0 / 2; let multiplier = sysclk / pllsrcclk; assert!(multiplier <= 16); ( Hertz(pllsrcclk * multiplier), Pllsrc::HSI_DIV2, into_pll_mul(multiplier), None, ) } } } }; ( act_sysclk, PllConfig { pll_src, pll_mul, pll_div, }, ) } #[inline] #[allow(unused_variables)] fn get_usb_pre(config: &Config, sysclk: Hertz, pclk1: Hertz, pll_config: &Option) -> Usbpre { cfg_if::cfg_if! { // Some chips do not have USB if #[cfg(any(stm32f301, stm32f318, stm32f334))] { panic!("USB clock not supported by the chip"); } else { let usb_ok = config.hse.is_some() && pll_config.is_some() && (pclk1 >= Hertz(10_000_000)); match (usb_ok, sysclk) { (true, Hertz(72_000_000)) => Usbpre::DIV1_5, (true, Hertz(48_000_000)) => Usbpre::DIV1, _ => panic!( "USB clock is only valid if the PLL output frequency is either 48MHz or 72MHz" ), } } } } // This function assumes cases when multiplier is one and it // being greater than 16 is made impossible #[inline] fn into_pll_mul(multiplier: u32) -> Pllmul { match multiplier { 2 => Pllmul::MUL2, 3 => Pllmul::MUL3, 4 => Pllmul::MUL4, 5 => Pllmul::MUL5, 6 => Pllmul::MUL6, 7 => Pllmul::MUL7, 8 => Pllmul::MUL8, 9 => Pllmul::MUL9, 10 => Pllmul::MUL10, 11 => Pllmul::MUL11, 12 => Pllmul::MUL12, 13 => Pllmul::MUL13, 14 => Pllmul::MUL14, 15 => Pllmul::MUL15, 16 => Pllmul::MUL16, _ => unreachable!(), } } // This function assumes the incoming divisor cannot be greater // than 16 #[inline] fn into_pre_div(divisor: u32) -> Prediv { match divisor { 1 => Prediv::DIV1, 2 => Prediv::DIV2, 3 => Prediv::DIV3, 4 => Prediv::DIV4, 5 => Prediv::DIV5, 6 => Prediv::DIV6, 7 => Prediv::DIV7, 8 => Prediv::DIV8, 9 => Prediv::DIV9, 10 => Prediv::DIV10, 11 => Prediv::DIV11, 12 => Prediv::DIV12, 13 => Prediv::DIV13, 14 => Prediv::DIV14, 15 => Prediv::DIV15, 16 => Prediv::DIV16, _ => unreachable!(), } } // Determine GCD using Euclidean algorithm #[inline] fn gcd(mut a: u32, mut b: u32) -> u32 { while b != 0 { let r = a % b; a = b; b = r; } a }