Skip to main content

Spi2CardGuard

Struct Spi2CardGuard 

Source
pub struct Spi2CardGuard<'a, CS: OutputPin> { /* private fields */ }
Expand description

The SPI2 bus and the card’s chip-select, held together.

This exists because chip-select continuity is not expressible from outside the BSP. SpiDevice::transaction asserts CS on entry and deasserts on exit, and one SD command is several transactions — the 0xFE data-token wait is unbounded, so it cannot be folded into a single fixed operation list. A driver holding only a SpiDevice therefore drops CS mid-command no matter how carefully it locks.

The BSP owns both halves, so it can hand them out together: take this guard once per command, assert CS yourself, and CS stays low for the whole exchange. Drop it between commands (and between busy-poll probes) so the display still gets the bus — a full-card erase must not freeze the UI.

Implementations§

Source§

impl<CS: OutputPin> Spi2CardGuard<'_, CS>

Source

pub fn split(&mut self) -> (&mut SpiBusType, &mut PresenceCs<CS>)

The bus and the chip-select, borrowed together for one command.

Source

pub fn apply_config(&mut self, config: &SpiConfig) -> Result<(), ConfigError>

Re-configure the bus while holding it — the SD clock raise after init(), in practice.

Needed because the card driver no longer holds a SpiDevice to carry a per-device config: it drives the bus directly, so the clock change has to happen here, under the same guard, or the card would stay at the 400 kHz init clock for its whole life.

Trait Implementations§

Source§

impl<CS: OutputPin> Drop for Spi2CardGuard<'_, CS>

Source§

fn drop(&mut self)

Deselect the card as the bus is released.

These are the same event: leaving CS low after the guard drops would leave the card selected while another master owns the bus, which is worse than the mid-command CS drops this guard exists to remove. It also lets the driver assert CS once per command and then use ? freely — every early return releases the card by unwinding here.

§

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)
Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned. Read more

Auto Trait Implementations§

§

impl<'a, CS> !RefUnwindSafe for Spi2CardGuard<'a, CS>

§

impl<'a, CS> !Send for Spi2CardGuard<'a, CS>

§

impl<'a, CS> !Sync for Spi2CardGuard<'a, CS>

§

impl<'a, CS> !UnwindSafe for Spi2CardGuard<'a, CS>

§

impl<'a, CS> Freeze for Spi2CardGuard<'a, CS>
where &'a mut PresenceCs<CS>: Freeze,

§

impl<'a, CS> PsramSafe for Spi2CardGuard<'a, CS>
where &'a mut PresenceCs<CS>: PsramSafe,

§

impl<'a, CS> Unpin for Spi2CardGuard<'a, CS>
where &'a mut PresenceCs<CS>: Unpin,

§

impl<'a, CS> UnsafeUnpin for Spi2CardGuard<'a, CS>
where &'a mut PresenceCs<CS>: UnsafeUnpin,

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.