Struct Rtc

pub struct Rtc {
    pub regs: RTC,
}

Fields

regs: RTC

Implementations

impl Rtc

pub fn new( regs: RTC, prediv_s: u16, prediv_a: u8, clock_source: RtcClock, clocks: Clocks, apb1: &mut APB1, pwr: &mut PWR, ) -> Option<Self>

Create and enable a new RTC, and configure its clock source and prescalers.

** Assumes 1970-01-01 00:00:00 Epoch **

See AN4759 (Rev 7) Table 7 for configuration of prediv_s and prediv_a, respectively the formula to calculate ck_spre on the same page.

For example, when using the LSE, set prediv_s to 255, and prediv_a to 127 to get a calendar clock of 1Hz.

Panics

A panic is triggered in case the RTC returns invalid a date or time, for example, hours greater than 23.

Note

This implementation assumes that the APB clock is greater than (>=) seven (7) times the RTC clock. This ensures a secure behavior of the synchronization mechanism.

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

Set the time using time::Time.

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

Set the seconds [0-59].

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

Set the minutes [0-59].

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

Set the hours [0-23].

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

Set the day of week [1-7].

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

Set the day of month [1-31].

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

Set the month [1-12].

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

Set the year [1970-2069].

The year cannot be less than 1970, since the Unix epoch is assumed (1970-01-01 00:00:00). Also, the year cannot be greater than 2069 since the RTC range is 0 - 99.

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

Set the date.

The year cannot be less than 1970, since the Unix epoch is assumed (1970-01-01 00:00:00). Also, the year cannot be greater than 2069 since the RTC range is 0 - 99.

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

Set the date and time.

The year cannot be less than 1970, since the Unix epoch is assumed (1970-01-01 00:00:00). Also, the year cannot be greater than 2069 since the RTC range is 0 - 99.

pub fn get_datetime(&mut self) -> PrimitiveDateTime