Struct LpuartRx 

pub struct LpuartRx<'a, M: Mode> { /* private fields */ }

Lpuart Rx driver.

Implementations

impl<'a> LpuartRx<'a, Blocking>

pub fn new_blocking<T: Instance>( _inner: Peri<'a, T>, rx_pin: Peri<'a, impl RxPin<T>>, config: Config, ) -> Result<Self, Error>

Create a new blocking LPUART Receiver instance.

Any external pin will be placed into Disabled state upon Drop.

pub fn new_blocking_with_rts<T: Instance>( _inner: Peri<'a, T>, rx_pin: Peri<'a, impl RxPin<T>>, rts_pin: Peri<'a, impl RtsPin<T>>, config: Config, ) -> Result<Self, Error>

Create a new blocking LPUART Receiver instance with RTS flow control.

Any external pin will be placed into Disabled state upon Drop.

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

Read data from LPUART RX without blocking.

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

Read data from LPUART RX blocking execution until the buffer is filled.

impl<'a> LpuartRx<'a, Buffered>

pub fn new<T: Instance>( _inner: Peri<'a, T>, rx_pin: Peri<'a, impl RxPin<T>>, _irq: impl Binding<T::Interrupt, BufferedInterruptHandler<T>> + 'a, rx_buffer: &'a mut [u8], config: Config, ) -> Result<Self, Error>

Create a new RX-only buffered LPUART.

Any external pin will be placed into Disabled state upon Drop.

SAFETY

You must NOT call core::mem::forget on LpuartRx if rx_buffer is not 'static. This will cause memory corruption.

pub fn new_with_rts<T: Instance>( _inner: Peri<'a, T>, rx_pin: Peri<'a, impl RxPin<T>>, rts_pin: Peri<'a, impl RtsPin<T>>, _irq: impl Binding<T::Interrupt, BufferedInterruptHandler<T>> + 'a, rx_buffer: &'a mut [u8], config: Config, ) -> Result<Self, Error>

Create a new RX-only buffered LPUART with RTS flow control.

Any external pin will be placed into Disabled state upon Drop.

SAFETY

You must NOT call core::mem::forget on LpuartRx if rx_buffer is not 'static. This will cause memory corruption.

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

Read data asynchronously

pub fn try_read(&mut self, buf: &mut [u8]) -> usize

Try to read without blocking

May return zero bytes if none are available, or the provided buffer is of zero length.

impl<'a> LpuartRx<'a, Dma<'a>>

pub fn new_async_with_dma<T: Instance>( _inner: Peri<'a, T>, rx_pin: Peri<'a, impl RxPin<T>>, rx_dma_ch: Peri<'a, impl Channel>, config: Config, ) -> Result<Self, Error>

Create a new LPUART RX driver with DMA support.

Any external pin will be placed into Disabled state upon Drop.

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

Read data using DMA.

This configures the DMA channel for a peripheral-to-memory transfer and waits for completion asynchronously. Large buffers are automatically split into chunks that fit within the DMA transfer limit.

The DMA request source is automatically derived from the LPUART instance type.

Safety

If the returned future is dropped before completion (e.g., due to a timeout), the DMA transfer is automatically aborted to prevent use-after-free.

Arguments

• buf - Buffer to receive data into

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

Blocking read (fallback when DMA is not needed)

pub fn into_ring_dma_rx<'buf: 'a>( &mut self, buf: &'buf mut [u8], ) -> RingBufferedLpuartRx<'_, 'buf>

Trait Implementations

impl<M: Mode> Drop for LpuartRx<'_, M>

fn drop(&mut self)

Executes the destructor for this type.

impl<M: Mode> ErrorType for LpuartRx<'_, M>

type Error = Error

Error type

impl<M: Mode> ErrorType for LpuartRx<'_, M>

type Error = Error

Error type of all the IO operations on this type.

impl Read for LpuartRx<'_, Blocking>

fn read(&mut self) -> Result<u8, Self::Error>

Reads a single word from the serial interface

impl Read for LpuartRx<'_, Blocking>

fn read(&mut self, buf: &mut [u8]) -> Result<usize, Self::Error>

Read some bytes from this source into the specified buffer, returning how many bytes were read.

fn read_exact( &mut self, buf: &mut [u8], ) -> Result<(), ReadExactError<Self::Error>>

Read the exact number of bytes required to fill buf.

impl Read for LpuartRx<'_, Buffered>

async fn read(&mut self, buf: &mut [u8]) -> Result<usize, Self::Error>

Read some bytes from this source into the specified buffer, returning how many bytes were read.

async fn read_exact( &mut self, buf: &mut [u8], ) -> Result<(), ReadExactError<Self::Error>>

Read the exact number of bytes required to fill buf.

impl<'a> Read for LpuartRx<'a, Dma<'a>>

async fn read(&mut self, buf: &mut [u8]) -> Result<usize, Self::Error>

Read some bytes from this source into the specified buffer, returning how many bytes were read.

async fn read_exact( &mut self, buf: &mut [u8], ) -> Result<(), ReadExactError<Self::Error>>

Read the exact number of bytes required to fill buf.

impl Read<u8> for LpuartRx<'_, Blocking>

type Error = Error

Read error

fn read(&mut self) -> Result<u8, Error<Self::Error>>

Reads a single word from the serial interface