Struct PeripheralRef

pub struct PeripheralRef<'a, T> { /* private fields */ }

An exclusive reference to a peripheral.

This is functionally the same as a &'a mut T. The reason for having a dedicated struct is memory efficiency:

Peripheral singletons are typically either zero-sized (for concrete peripherals like SPI2 or UART0) or very small (for example AnyPin which is 1 byte). However &mut T is always 4 bytes for 32-bit targets, even if T is zero-sized. PeripheralRef stores a copy of T instead, so it’s the same size.

but it is the size of T not the size of a pointer. This is useful if T is a zero sized type.

Implementations

impl<'a, T> PeripheralRef<'a, T>

pub fn new(inner: T) -> Self

Create a new exclusive reference to a peripheral

pub unsafe fn clone_unchecked(&self) -> PeripheralRef<'a, T>

where T: Peripheral<P = T>,

Unsafely clone (duplicate) a peripheral singleton.

Safety

This returns an owned clone of the peripheral. You must manually ensure only one copy of the peripheral is in use at a time. For example, don’t create two SPI drivers on SPI1, because they will “fight” each other.

You should strongly prefer using reborrow() instead. It returns a PeripheralRef that borrows self, which allows the borrow checker to enforce this at compile time.

pub fn reborrow(&mut self) -> PeripheralRef<'_, T>

where T: Peripheral<P = T>,

Reborrow into a “child” PeripheralRef.

self will stay borrowed until the child PeripheralRef is dropped.

pub fn map_into<U>(self) -> PeripheralRef<'a, U>

where T: Into<U>,

Map the inner peripheral using Into.

This converts from PeripheralRef<'a, T> to PeripheralRef<'a, U>, using an Into impl to convert from T to U.

For example, this can be useful to degrade GPIO pins: converting from PeripheralRef<’a, GpioPin<11>>toPeripheralRef<’a, AnyPin>`.

Trait Implementations

impl<T> Deref for PeripheralRef<'_, T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<T> DerefMut for PeripheralRef<'_, T>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<T: Peripheral> Peripheral for PeripheralRef<'_, T>

type P = <T as Peripheral>::P

Peripheral singleton type

unsafe fn clone_unchecked(&self) -> Self::P

Unsafely clone (duplicate) a peripheral singleton.

fn into_ref<'a>(self) -> PeripheralRef<'a, Self::P>

where Self: 'a,

Convert a value into a PeripheralRef.

fn map_into<U>(self) -> U

where Self::P: Into<U>, U: Peripheral<P = U>,

Map the peripheral using Into.