Skip to main content

SystemResources

Struct SystemResources 

Source
pub struct SystemResources<'a> {
    pub sw_int: SoftwareInterrupts<'a>,
    pub timer0_0: AnyTimer<'a>,
    pub timer0_1: AnyTimer<'a>,
    pub timer1_0: AnyTimer<'a>,
    pub timer1_1: AnyTimer<'a>,
    pub cpu_ctrl: CPU_CTRL<'a>,
    pub lpwr: LPWR<'a>,
    pub flash: FLASH<'a>,
    pub aes: AES<'a>,
    pub rtc_timer: RTC_TIMER<'a>,
}
Expand description

Chip-level (board-independent) system resources: executor timers, software interrupts, the second core, and the RTC domain (e.g. the production RWDT, crate::io::watchdog).

Fields§

§sw_int: SoftwareInterrupts<'a>§timer0_0: AnyTimer<'a>§timer0_1: AnyTimer<'a>§timer1_0: AnyTimer<'a>§timer1_1: AnyTimer<'a>§cpu_ctrl: CPU_CTRL<'a>§lpwr: LPWR<'a>

RTC peripheral — RTC domain registers (reset reason, RTC-fast memory).

§flash: FLASH<'a>

Internal SPI flash — what esp_hal::flash::Flash::new takes, so a consumer can persist settings in its own partition.

Handed out rather than kept because the BSP has no opinion about what belongs in flash. Note the cost that comes with it: on a dual-core part an erase requires the other core to stop fetching from flash, so a write parks it for tens of milliseconds. That is the caller’s problem to schedule, and it is why this is a peripheral rather than a convenience method.

§aes: AES<'a>

AES accelerator — one 16-byte block per encrypt/decrypt call.

No board wiring, handed out like Self::flash: a consumer that decrypts on a hot path wants it instead of a software cipher, which on xtensa is kilobytes of code plus a key schedule per message.

§rtc_timer: RTC_TIMER<'a>

RTC timer singleton — what Rtc::new takes as of esp-hal 1.2, which split it out of LPWR. Handed out separately because the two are now distinct peripherals: a consumer arming the production RWDT (crate::io::watchdog) needs THIS, while lpwr still covers the RTC-domain registers. Before 1.2 Rtc::new(lpwr) covered both, so a board that only exposed lpwr silently stopped being able to build an Rtc at all.

Auto Trait Implementations§

§

impl<'a> !RefUnwindSafe for SystemResources<'a>

§

impl<'a> !Sync for SystemResources<'a>

§

impl<'a> !UnwindSafe for SystemResources<'a>

§

impl<'a> Freeze for SystemResources<'a>

§

impl<'a> PsramSafe for SystemResources<'a>

§

impl<'a> Send for SystemResources<'a>

§

impl<'a> Unpin for SystemResources<'a>

§

impl<'a> UnsafeUnpin for SystemResources<'a>

Blanket Implementations§

§

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

§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Az for T

Source§

fn az<Dst>(self) -> Dst
where T: Cast<Dst>,

Casts the value.
§

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

§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
§

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

§

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

Mutably borrows from an owned value. Read more
Source§

impl<Src, Dst> CastFrom<Src> for Dst
where Src: Cast<Dst>,

Source§

fn cast_from(src: Src) -> Dst

Casts the value.
§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> CheckedAs for T

Source§

fn checked_as<Dst>(self) -> Option<Dst>
where T: CheckedCast<Dst>,

Casts the value.
Source§

impl<Src, Dst> CheckedCastFrom<Src> for Dst
where Src: CheckedCast<Dst>,

Source§

fn checked_cast_from(src: Src) -> Option<Dst>

Casts the value.
§

impl<T> From<T> for T

§

fn from(t: T) -> T

Returns the argument unchanged.

§

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

§

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<Src, Dst> LosslessTryInto<Dst> for Src
where Dst: LosslessTryFrom<Src>,

Source§

fn lossless_try_into(self) -> Option<Dst>

Performs the conversion.
Source§

impl<Src, Dst> LossyInto<Dst> for Src
where Dst: LossyFrom<Src>,

Source§

fn lossy_into(self) -> Dst

Performs the conversion.
Source§

impl<T> OverflowingAs for T

Source§

fn overflowing_as<Dst>(self) -> (Dst, bool)
where T: OverflowingCast<Dst>,

Casts the value.
Source§

impl<Src, Dst> OverflowingCastFrom<Src> for Dst
where Src: OverflowingCast<Dst>,

Source§

fn overflowing_cast_from(src: Src) -> (Dst, bool)

Casts the value.
§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> SaturatingAs for T

Source§

fn saturating_as<Dst>(self) -> Dst
where T: SaturatingCast<Dst>,

Casts the value.
Source§

impl<Src, Dst> SaturatingCastFrom<Src> for Dst
where Src: SaturatingCast<Dst>,

Source§

fn saturating_cast_from(src: Src) -> Dst

Casts the value.
§

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

§

type Error = !

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

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

Performs the conversion.
§

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

§

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

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

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

Performs the conversion.
Source§

impl<T> UnwrappedAs for T

Source§

fn unwrapped_as<Dst>(self) -> Dst
where T: UnwrappedCast<Dst>,

Casts the value.
Source§

impl<Src, Dst> UnwrappedCastFrom<Src> for Dst
where Src: UnwrappedCast<Dst>,

Source§

fn unwrapped_cast_from(src: Src) -> Dst

Casts the value.
Source§

impl<T> WrappingAs for T

Source§

fn wrapping_as<Dst>(self) -> Dst
where T: WrappingCast<Dst>,

Casts the value.
Source§

impl<Src, Dst> WrappingCastFrom<Src> for Dst
where Src: WrappingCast<Dst>,

Source§

fn wrapping_cast_from(src: Src) -> Dst

Casts the value.