Struct Transfer 

pub struct Transfer<const N: u8, P, BUF>
where
    Channel<N>: ChannelOps,
    P: DmaPeriph<N>,
{ /* private fields */ }

A DMA transfer in progress, started by Channel::write_to or read_from.

Owns the channel, the peripheral and the buffer for as long as the transfer runs; wait is the only way to get them back.

Dropping instead of waiting stops the transfer and loses all three parts.

Implementations

impl<const N: u8, P, BUF> Transfer<N, P, BUF>

where Channel<N>: ChannelOps, P: DmaPeriph<N>,

pub fn wait(self) -> (Channel<N>, P, BUF)

Blocks until the transfer completes, then returns the channel, the peripheral and the buffer.

Does not check ERRIF: every address this API can hand a channel comes from a typed source, so a bus error is unreachable through safe code.

pub fn remaining(&self) -> u16

How many transfers the channel has left, without waiting for it.

Counts transfers, not bytes: at Width::Bits16 a unit is two bytes on the wire. A snapshot only — the hardware keeps counting while the caller looks at it, so it serves progress reporting.

pub fn is_error(&self) -> bool

Whether the channel has raised ERRIF, having hit a bus error.

Useful next to remaining to tell a stalled channel from a failed one.

Trait Implementations

impl<const N: u8, P, BUF> Drop for Transfer<N, P, BUF>

where Channel<N>: ChannelOps, P: DmaPeriph<N>,

fn drop(&mut self)

Stops the transfer where it stands, without waiting for it to finish.

The tail of wait without the blocking: a running channel is cut off mid-buffer.

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.