Struct stm32_hal2::rtc::Rtc

pub struct Rtc { /* fields omitted */ }

Represents a Real Time Clock (RTC) peripheral.

Implementations

impl Rtc

pub fn new(regs: RTC, pwr: &mut PWR, config: RtcConfig) -> Self

Create and enable a new RTC abstraction, and configure its clock source and prescalers. From AN4759, Table 7, when using the LSE (The only clock source this module supports currently), set prediv_s to 255, and prediv_a to 127 to get a calendar clock of 1Hz. The bypass argument is true if you’re using an external oscillator that doesn’t connect to OSC32_IN, such as a MEMS resonator. Note that if using HSE as the clock source, we assume you’ve already enabled it, eg in clock config.

pub fn set_24h_fmt(&mut self)

Sets calendar clock to 24 hr format

pub fn set_12h_fmt(&mut self)

Sets calendar clock to 12 hr format

pub fn is_24h_fmt(&self) -> bool

Reads current hour format selection

pub fn set_wakeup(&mut self, exti: &mut EXTI, sleep_time: f32)

Setup periodic auto-wakeup interrupts. See ST AN4759, Table 11, and more broadly, section 2.4.1. See also reference manual, section 27.5. In addition to running this function, set up the interrupt handling function by adding the line make_rtc_interrupt_handler!(RTC_WKUP); somewhere in the body of your program. sleep_time is in ms.

pub fn enable_wakeup(&mut self)

Enable the wakeup timer.

pub fn disable_wakeup(&mut self)

Disable the wakeup timer. // todo dry with enable.

pub fn set_wakeup_interval(&mut self, sleep_time: f32)

Change the sleep time for the auto wakeup, after it’s been set up. Sleep time is in MS. Major DRY from set_wakeup.

pub fn clear_wakeup_flag(&mut self)

Clears the wakeup flag. Must be cleared manually after every RTC wakeup. Alternatively, you could call this in the RTC wakeup interrupt handler.

pub fn set_time(&mut self, time: &NaiveTime) -> Result<(), Error>

set time using NaiveTime (ISO 8601 time without timezone) Hour format is 24h

pub fn set_seconds(&mut self, seconds: u8) -> Result<(), Error>

pub fn set_minutes(&mut self, minutes: u8) -> Result<(), Error>

pub fn set_hours(&mut self, hours: u8) -> Result<(), Error>

pub fn set_weekday(&mut self, weekday: u8) -> Result<(), Error>

pub fn set_day(&mut self, day: u8) -> Result<(), Error>

pub fn set_month(&mut self, month: u8) -> Result<(), Error>

pub fn set_year(&mut self, year: u16) -> Result<(), Error>

pub fn set_date(&mut self, date: &NaiveDate) -> Result<(), Error>

Set the date using NaiveDate (ISO 8601 calendar date without timezone). WeekDay is set using the set_weekday method

pub fn set_datetime(&mut self, date: &NaiveDateTime) -> Result<(), Error>

pub fn get_seconds(&mut self) -> u8

pub fn get_minutes(&mut self) -> u8

pub fn get_hours(&mut self) -> u8

pub fn get_time(&mut self) -> NaiveTime

pub fn get_weekday(&mut self) -> u8

pub fn get_day(&mut self) -> u8

pub fn get_month(&mut self) -> u8

pub fn get_year(&mut self) -> u16

pub fn get_date(&mut self) -> NaiveDate

pub fn get_datetime(&mut self) -> NaiveDateTime