embassy-stm32

Crates

git

Versions

stm32u585ci

Flavors

Skip to main content

RawDateTime

Struct RawDateTime 

Source
pub struct RawDateTime {
    pub year: u8,
    pub month: u8,
    pub day: u8,
    pub day_of_week: u8,
    pub hour: u8,
    pub minute: u8,
    pub second: u8,
    pub subsecond: u16,
}
Expand description

Raw contents of the RTC calendar registers.

This is a dumb container for the values in the RTC time and date registers, decoded from BCD. It does no validation whatsoever: it can hold dates that do not exist (February 30, month 0, hour 61…), and Rtc::set_raw writes whatever it holds to the hardware. Out-of-range values are truncated to the width of the register fields.

It is meant for code that cares about the last few hundred bytes of flash, or that needs the hardware day of week. For anything else, enable the jiff feature and use RtcTimeProvider::read and Rtc::set, which work with validated jiff::civil::DateTime values.

Fields§

§year: u8

Year within the century, as stored in the RTC, 0..=99. The jiff API takes it as the years 2000 to 2099.

§month: u8

Month, 1..=12, 1 is January.

§day: u8

Day of the month, 1..=31.

§day_of_week: u8

Day of the week, 1..=7, 1 is Monday. The hardware does not allow 0.

The RTC does not check it against the date, it only increments it every day, wrapping from 7 to 1.

§hour: u8

Hour, 0..=23.

§minute: u8

Minute, 0..=59.

§second: u8

Second, 0..=59.

§subsecond: u16

Subsecond counter, the SS field of RTC_SSR.

It counts down from PREDIV_S (RTC_PRER) to 0 once per second, so the fraction of the current second that has elapsed is (PREDIV_S - subsecond) / (PREDIV_S + 1). Right after Rtc::synchronize it can be above PREDIV_S, meaning the time is still before second.

Rtc::set_raw ignores it: setting the calendar resets the counter.

Trait Implementations§

Source§

impl Clone for RawDateTime

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Copy for RawDateTime

Source§

impl Debug for RawDateTime

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Eq for RawDateTime

Source§

impl Format for RawDateTime

Source§

fn format(&self, f: Formatter<'_>)

Writes the defmt representation of self to fmt.
Source§

impl PartialEq for RawDateTime

Source§

fn eq(&self, other: &Self) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=. Read more
Source§

impl StructuralPartialEq for RawDateTime

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T, I> Binding<I, NoHandler<I>> for T
where T: Copy, I: Interrupt,

Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.