//! RTC peripheral abstraction mod datetime; #[cfg(feature = "low-power")] use core::cell::Cell; #[cfg(feature = "low-power")] use embassy_sync::blocking_mutex::raw::CriticalSectionRawMutex; #[cfg(feature = "low-power")] use embassy_sync::blocking_mutex::Mutex; pub use self::datetime::{DateTime, DayOfWeek, Error as DateTimeError}; use crate::time::Hertz; /// refer to AN4759 to compare features of RTC2 and RTC3 #[cfg_attr(any(rtc_v1), path = "v1.rs")] #[cfg_attr( any( rtc_v2f0, rtc_v2f2, rtc_v2f3, rtc_v2f4, rtc_v2f7, rtc_v2h7, rtc_v2l0, rtc_v2l1, rtc_v2l4, rtc_v2wb ), path = "v2.rs" )] #[cfg_attr(any(rtc_v3, rtc_v3u5), path = "v3.rs")] mod _version; #[allow(unused_imports)] pub use _version::*; use embassy_hal_internal::Peripheral; use crate::peripherals::RTC; use crate::rtc::sealed::Instance; /// Errors that can occur on methods on [RtcClock] #[derive(Clone, Debug, PartialEq, Eq)] pub enum RtcError { /// An invalid DateTime was given or stored on the hardware. InvalidDateTime(DateTimeError), /// The RTC clock is not running NotRunning, } #[cfg(feature = "low-power")] /// Represents an instant in time that can be substracted to compute a duration struct RtcInstant { second: u8, subsecond: u16, } #[cfg(all(feature = "low-power", feature = "defmt"))] impl defmt::Format for RtcInstant { fn format(&self, fmt: defmt::Formatter) { defmt::write!( fmt, "{}:{}", self.second, RTC::regs().prer().read().prediv_s() - self.subsecond, ) } } #[cfg(feature = "low-power")] impl core::ops::Sub for RtcInstant { type Output = embassy_time::Duration; fn sub(self, rhs: Self) -> Self::Output { use embassy_time::{Duration, TICK_HZ}; let second = if self.second < rhs.second { self.second + 60 } else { self.second }; let psc = RTC::regs().prer().read().prediv_s() as u32; let self_ticks = second as u32 * (psc + 1) + (psc - self.subsecond as u32); let other_ticks = rhs.second as u32 * (psc + 1) + (psc - rhs.subsecond as u32); let rtc_ticks = self_ticks - other_ticks; Duration::from_ticks(((rtc_ticks * TICK_HZ as u32) / (psc + 1)) as u64) } } pub struct RtcTimeProvider { _private: (), } impl RtcTimeProvider { /// Return the current datetime. /// /// # Errors /// /// Will return an `RtcError::InvalidDateTime` if the stored value in the system is not a valid [`DayOfWeek`]. pub fn now(&self) -> Result { // For RM0433 we use BYPSHAD=1 to work around errata ES0392 2.19.1 #[cfg(rcc_h7rm0433)] loop { let r = RTC::regs(); let ss = r.ssr().read().ss(); let dr = r.dr().read(); let tr = r.tr().read(); // If an RTCCLK edge occurs during read we may see inconsistent values // so read ssr again and see if it has changed. (see RM0433 Rev 7 46.3.9) let ss_after = r.ssr().read().ss(); if ss == ss_after { let second = bcd2_to_byte((tr.st(), tr.su())); let minute = bcd2_to_byte((tr.mnt(), tr.mnu())); let hour = bcd2_to_byte((tr.ht(), tr.hu())); let weekday = dr.wdu(); let day = bcd2_to_byte((dr.dt(), dr.du())); let month = bcd2_to_byte((dr.mt() as u8, dr.mu())); let year = bcd2_to_byte((dr.yt(), dr.yu())) as u16 + 1970_u16; return self::datetime::datetime(year, month, day, weekday, hour, minute, second) .map_err(RtcError::InvalidDateTime); } } #[cfg(not(rcc_h7rm0433))] { let r = RTC::regs(); let tr = r.tr().read(); let second = bcd2_to_byte((tr.st(), tr.su())); let minute = bcd2_to_byte((tr.mnt(), tr.mnu())); let hour = bcd2_to_byte((tr.ht(), tr.hu())); // Reading either RTC_SSR or RTC_TR locks the values in the higher-order // calendar shadow registers until RTC_DR is read. let dr = r.dr().read(); let weekday = dr.wdu(); let day = bcd2_to_byte((dr.dt(), dr.du())); let month = bcd2_to_byte((dr.mt() as u8, dr.mu())); let year = bcd2_to_byte((dr.yt(), dr.yu())) as u16 + 1970_u16; self::datetime::datetime(year, month, day, weekday, hour, minute, second).map_err(RtcError::InvalidDateTime) } } } /// RTC Abstraction pub struct Rtc { #[cfg(feature = "low-power")] stop_time: Mutex>>, #[cfg(not(feature = "low-power"))] _private: (), } #[non_exhaustive] #[derive(Copy, Clone, PartialEq)] pub struct RtcConfig { /// The subsecond counter frequency; default is 256 /// /// A high counter frequency may impact stop power consumption pub frequency: Hertz, } impl Default for RtcConfig { /// LSI with prescalers assuming 32.768 kHz. /// Raw sub-seconds in 1/256. fn default() -> Self { RtcConfig { frequency: Hertz(256) } } } #[derive(Copy, Clone, Debug, PartialEq)] #[repr(u8)] pub enum RtcCalibrationCyclePeriod { /// 8-second calibration period Seconds8, /// 16-second calibration period Seconds16, /// 32-second calibration period Seconds32, } impl Default for RtcCalibrationCyclePeriod { fn default() -> Self { RtcCalibrationCyclePeriod::Seconds32 } } impl Rtc { pub fn new(_rtc: impl Peripheral

, rtc_config: RtcConfig) -> Self { #[cfg(not(any(stm32l0, stm32f3, stm32l1, stm32f0, stm32f2)))] ::reset_and_enable(); let mut this = Self { #[cfg(feature = "low-power")] stop_time: Mutex::const_new(CriticalSectionRawMutex::new(), Cell::new(None)), #[cfg(not(feature = "low-power"))] _private: (), }; let frequency = Self::frequency(); let async_psc = ((frequency.0 / rtc_config.frequency.0) - 1) as u8; let sync_psc = (rtc_config.frequency.0 - 1) as u16; this.configure(async_psc, sync_psc); this } fn frequency() -> Hertz { let freqs = unsafe { crate::rcc::get_freqs() }; freqs.rtc.unwrap() } /// Acquire a [`RtcTimeProvider`] instance. pub const fn time_provider(&self) -> RtcTimeProvider { RtcTimeProvider { _private: () } } /// Set the datetime to a new value. /// /// # Errors /// /// Will return `RtcError::InvalidDateTime` if the datetime is not a valid range. pub fn set_datetime(&mut self, t: DateTime) -> Result<(), RtcError> { self::datetime::validate_datetime(&t).map_err(RtcError::InvalidDateTime)?; self.write(true, |rtc| self::datetime::write_date_time(rtc, t)); Ok(()) } #[cfg(feature = "low-power")] /// Return the current instant. fn instant(&self) -> RtcInstant { let r = RTC::regs(); let tr = r.tr().read(); let subsecond = r.ssr().read().ss(); let second = bcd2_to_byte((tr.st(), tr.su())); // Unlock the registers r.dr().read(); RtcInstant { second, subsecond } } /// Return the current datetime. /// /// # Errors /// /// Will return an `RtcError::InvalidDateTime` if the stored value in the system is not a valid [`DayOfWeek`]. pub fn now(&self) -> Result { self.time_provider().now() } /// Check if daylight savings time is active. pub fn get_daylight_savings(&self) -> bool { let cr = RTC::regs().cr().read(); cr.bkp() } /// Enable/disable daylight savings time. pub fn set_daylight_savings(&mut self, daylight_savings: bool) { self.write(true, |rtc| { rtc.cr().modify(|w| w.set_bkp(daylight_savings)); }) } pub const BACKUP_REGISTER_COUNT: usize = RTC::BACKUP_REGISTER_COUNT; /// Read content of the backup register. /// /// The registers retain their values during wakes from standby mode or system resets. They also /// retain their value when Vdd is switched off as long as V_BAT is powered. pub fn read_backup_register(&self, register: usize) -> Option { RTC::read_backup_register(&RTC::regs(), register) } /// Set content of the backup register. /// /// The registers retain their values during wakes from standby mode or system resets. They also /// retain their value when Vdd is switched off as long as V_BAT is powered. pub fn write_backup_register(&self, register: usize, value: u32) { RTC::write_backup_register(&RTC::regs(), register, value) } } pub(crate) fn byte_to_bcd2(byte: u8) -> (u8, u8) { let mut bcd_high: u8 = 0; let mut value = byte; while value >= 10 { bcd_high += 1; value -= 10; } (bcd_high, ((bcd_high << 4) | value) as u8) } pub(crate) fn bcd2_to_byte(bcd: (u8, u8)) -> u8 { let value = bcd.1 | bcd.0 << 4; let tmp = ((value & 0xF0) >> 0x4) * 10; tmp + (value & 0x0F) } pub(crate) mod sealed { use crate::pac::rtc::Rtc; pub trait Instance { const BACKUP_REGISTER_COUNT: usize; #[cfg(feature = "low-power")] const EXTI_WAKEUP_LINE: usize; #[cfg(feature = "low-power")] type WakeupInterrupt: crate::interrupt::typelevel::Interrupt; fn regs() -> Rtc { crate::pac::RTC } /// Read content of the backup register. /// /// The registers retain their values during wakes from standby mode or system resets. They also /// retain their value when Vdd is switched off as long as V_BAT is powered. fn read_backup_register(rtc: &Rtc, register: usize) -> Option; /// Set content of the backup register. /// /// The registers retain their values during wakes from standby mode or system resets. They also /// retain their value when Vdd is switched off as long as V_BAT is powered. fn write_backup_register(rtc: &Rtc, register: usize, value: u32); // fn apply_config(&mut self, rtc_config: RtcConfig); } }