Struct SerialDma

pub struct SerialDma<Serial_: Instance, TX_TRANSFER, RX_TRANSFER> { /* private fields */ }

Serial abstraction that can work in non-blocking mode by using DMA

The struct should be used for sending/receiving bytes to/from the serial interface in non-blocking mode. A client must follow these requirements to use that feature:

• Enable interrupts DMAx_STREAMy used for transmit and another DMAq_STREAMp used for receive.
• In these interrupts call handle_dma_interrupt; defined in trait SerialHandleIT.
• Enable interrupts USARTx or UARTx for handling errors and call handle_error_interrupt in corresponding handler; defined in trait SerialHandleIT.

The struct can be also used to send/receive bytes in blocking mode with methods: write, read, write_read.

Implementations

impl<Serial_: Instance, TX_TRANSFER, RX_TRANSFER> SerialDma<Serial_, TX_TRANSFER, RX_TRANSFER>

where TX_TRANSFER: DMATransfer<&'static [u8]>, RX_TRANSFER: DMATransfer<&'static mut [u8]>,

Common implementation

pub fn write(&mut self, bytes: &[u8]) -> Result<(), Error>

pub fn read(&mut self, bytes: &mut [u8]) -> Result<(), Error>

Trait Implementations

impl<Serial_: Instance, RX_STREAM, const RX_CH: u8> SerialHandleIT for SerialDma<Serial_, NoDMA, RxDMA<Serial_, RX_STREAM, RX_CH>>

where RX_STREAM: Stream, ChannelX<RX_CH>: Channel, Rx<Serial_>: DMASet<RX_STREAM, RX_CH, PeripheralToMemory>,

fn handle_dma_interrupt(&mut self)

fn handle_error_interrupt(&mut self)

impl<Serial_: Instance, TX_STREAM, const TX_CH: u8> SerialHandleIT for SerialDma<Serial_, TxDMA<Serial_, TX_STREAM, TX_CH>, NoDMA>

where TX_STREAM: Stream, ChannelX<TX_CH>: Channel, Tx<Serial_>: DMASet<TX_STREAM, TX_CH, MemoryToPeripheral>,

fn handle_dma_interrupt(&mut self)

fn handle_error_interrupt(&mut self)

impl<Serial_: Instance, TX_STREAM, const TX_CH: u8, RX_STREAM, const RX_CH: u8> SerialHandleIT for SerialDma<Serial_, TxDMA<Serial_, TX_STREAM, TX_CH>, RxDMA<Serial_, RX_STREAM, RX_CH>>

where TX_STREAM: Stream, ChannelX<TX_CH>: Channel, Tx<Serial_>: DMASet<TX_STREAM, TX_CH, MemoryToPeripheral>, RX_STREAM: Stream, ChannelX<RX_CH>: Channel, Rx<Serial_>: DMASet<RX_STREAM, RX_CH, PeripheralToMemory>,

Only for both TX and RX DMA

fn handle_dma_interrupt(&mut self)

fn handle_error_interrupt(&mut self)

impl<Serial_: Instance, TX_TRANSFER, RX_STREAM, const RX_CH: u8> SerialReadDMA for SerialDma<Serial_, TX_TRANSFER, RxDMA<Serial_, RX_STREAM, RX_CH>>

where RX_STREAM: Stream, ChannelX<RX_CH>: Channel, Rx<Serial_>: DMASet<RX_STREAM, RX_CH, PeripheralToMemory>, TX_TRANSFER: DMATransfer<&'static [u8]>,

unsafe fn read_dma( &mut self, buf: &mut [u8], callback: Option<SerialCompleteCallback>, ) -> Result<(), Error>

Reads bytes from the serial interface in non-blocking mode and writes these bytes in buf

impl<Serial_: Instance, TX_STREAM, const TX_CH: u8, RX_TRANSFER> SerialWriteDMA for SerialDma<Serial_, TxDMA<Serial_, TX_STREAM, TX_CH>, RX_TRANSFER>

where TX_STREAM: Stream, ChannelX<TX_CH>: Channel, Tx<Serial_>: DMASet<TX_STREAM, TX_CH, MemoryToPeripheral>, RX_TRANSFER: DMATransfer<&'static mut [u8]>,

unsafe fn write_dma( &mut self, bytes: &[u8], callback: Option<SerialCompleteCallback>, ) -> Result<(), Error>

Writes bytes to the serial interface in non-blocking mode