//! 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; use self::datetime::day_of_week_to_u8; #[cfg(not(rtc_v2f2))] use self::datetime::RtcInstant; pub use self::datetime::{DateTime, DayOfWeek, Error as DateTimeError}; use crate::pac::rtc::regs::{Dr, Tr}; 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] #[non_exhaustive] #[derive(Clone, Debug, PartialEq, Eq)] pub enum RtcError { /// An invalid DateTime was given or stored on the hardware. InvalidDateTime(DateTimeError), /// The current time could not be read ReadFailure, /// The RTC clock is not running NotRunning, } pub struct RtcTimeProvider { _private: (), } impl RtcTimeProvider { #[cfg(not(rtc_v2f2))] pub(crate) fn instant(&self) -> Result { self.read(|_, tr, ss| { let second = bcd2_to_byte((tr.st(), tr.su())); RtcInstant::from(second, ss).map_err(RtcError::InvalidDateTime) }) } /// 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.read(|dr, tr, _| { 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; DateTime::from(year, month, day, weekday, hour, minute, second).map_err(RtcError::InvalidDateTime) }) } fn read(&self, mut f: impl FnMut(Dr, Tr, u16) -> Result) -> Result { let r = RTC::regs(); #[cfg(not(rtc_v2f2))] let read_ss = || r.ssr().read().ss(); #[cfg(rtc_v2f2)] let read_ss = || 0; let mut ss = read_ss(); for _ in 0..5 { let tr = r.tr().read(); let dr = r.dr().read(); let ss_after = read_ss(); // 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) if ss == ss_after { return f(dr, tr, ss.try_into().unwrap()); } else { ss = ss_after } } return Err(RtcError::ReadFailure); } } /// 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)))] critical_section::with(|cs| { ::enable_and_reset_with_cs(cs); #[cfg(feature = "low-power")] unsafe { crate::rcc::REFCOUNT_STOP2 -= 1 }; }); 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); // Wait for the clock to update after initialization #[cfg(not(rtc_v2f2))] { let now = this.instant().unwrap(); while this.instant().unwrap().subsecond == now.subsecond {} } 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.write(true, |rtc| { let (ht, hu) = byte_to_bcd2(t.hour() as u8); let (mnt, mnu) = byte_to_bcd2(t.minute() as u8); let (st, su) = byte_to_bcd2(t.second() as u8); let (dt, du) = byte_to_bcd2(t.day() as u8); let (mt, mu) = byte_to_bcd2(t.month() as u8); let yr = t.year() as u16; let yr_offset = (yr - 1970_u16) as u8; let (yt, yu) = byte_to_bcd2(yr_offset); use crate::pac::rtc::vals::Ampm; rtc.tr().write(|w| { w.set_ht(ht); w.set_hu(hu); w.set_mnt(mnt); w.set_mnu(mnu); w.set_st(st); w.set_su(su); w.set_pm(Ampm::AM); }); rtc.dr().write(|w| { w.set_dt(dt); w.set_du(du); w.set_mt(mt > 0); w.set_mu(mu); w.set_yt(yt); w.set_yu(yu); w.set_wdu(day_of_week_to_u8(t.day_of_week())); }); }); Ok(()) } #[cfg(not(rtc_v2f2))] /// Return the current instant. fn instant(&self) -> Result { self.time_provider().instant() } /// 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); } }