Struct Rtc

pub struct Rtc { /* private fields */ }

Available on crate feature rtc only.

Real Time Clock peripheral

Implementations

impl Rtc

pub fn new( rtc: RTC, prediv_s: u16, prediv_a: u8, bypass: bool, apb1: &mut APB1, bdcr: &mut BDCR, pwr: &mut PWR, ) -> Self

Create and enable a new RTC, 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.

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 unsafe fn peripheral(&mut self) -> &mut RTC

Get access to the underlying register block.

Safety

This function is not memory unsafe per se, but does not guarantee anything about assumptions of invariants made in this implementation.

Changing specific options can lead to un-expected behavior and nothing is guaranteed.

pub fn free(self) -> RTC

Release the RTC peripheral

Trait Implementations

impl DateTimeAccess for Rtc

type Error = Error

Error type

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

Set the date and time.

fn datetime(&mut self) -> Result<NaiveDateTime, Self::Error>

Read the date and time.

impl Debug for Rtc

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Rtcc for Rtc

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

Set time using NaiveTime (ISO 8601 time without timezone)

Hour format is 24h

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

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

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

Set the seconds [0-59].

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

Set the minutes [0-59].

fn set_hours(&mut self, hours: Hours) -> Result<(), Self::Error>

Set the hours.

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

Set the day of week [1-7].

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

Set the day of month [1-31].

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

Set the month [1-12].

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

Set the year. (e.g. 2000)

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

Read the seconds.

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

Read the minutes.

fn hours(&mut self) -> Result<Hours, Self::Error>

Read the hours.

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

Read the time.

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

Read the day of the week [1-7].

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

Read the day of the month [1-31].

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

Read the month [1-12].

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

Read the year (e.g. 2000).

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

Read the date.