embassy-nrf

Crates

git

Versions

nrf5340-net

Flavors

embassy_nrf::buffered_uarte

Struct BufferedUarte

Source
pub struct BufferedUarte<'d, U: UarteInstance, T: TimerInstance> { /* private fields */ }
Expand description

Buffered UARTE driver.

Implementations§

Source§

impl<'d, U: UarteInstance, T: TimerInstance> BufferedUarte<'d, U, T>

Source

pub fn new( uarte: impl Peripheral<P = U> + 'd, timer: impl Peripheral<P = T> + 'd, ppi_ch1: impl Peripheral<P = impl ConfigurableChannel> + 'd, ppi_ch2: impl Peripheral<P = impl ConfigurableChannel> + 'd, ppi_group: impl Peripheral<P = impl Group> + 'd, _irq: impl Binding<U::Interrupt, InterruptHandler<U>> + 'd, rxd: impl Peripheral<P = impl GpioPin> + 'd, txd: impl Peripheral<P = impl GpioPin> + 'd, config: Config, rx_buffer: &'d mut [u8], tx_buffer: &'d mut [u8], ) -> Self

Create a new BufferedUarte without hardware flow control.

§Panics

Panics if rx_buffer.len() is odd.

Source

pub fn new_with_rtscts( uarte: impl Peripheral<P = U> + 'd, timer: impl Peripheral<P = T> + 'd, ppi_ch1: impl Peripheral<P = impl ConfigurableChannel> + 'd, ppi_ch2: impl Peripheral<P = impl ConfigurableChannel> + 'd, ppi_group: impl Peripheral<P = impl Group> + 'd, _irq: impl Binding<U::Interrupt, InterruptHandler<U>> + 'd, rxd: impl Peripheral<P = impl GpioPin> + 'd, txd: impl Peripheral<P = impl GpioPin> + 'd, cts: impl Peripheral<P = impl GpioPin> + 'd, rts: impl Peripheral<P = impl GpioPin> + 'd, config: Config, rx_buffer: &'d mut [u8], tx_buffer: &'d mut [u8], ) -> Self

Create a new BufferedUarte with hardware flow control (RTS/CTS)

§Panics

Panics if rx_buffer.len() is odd.

Source

pub fn set_baudrate(&mut self, baudrate: Baudrate)

Adjust the baud rate to the provided value.

Source

pub fn split(self) -> (BufferedUarteRx<'d, U, T>, BufferedUarteTx<'d, U>)

Split the UART in reader and writer parts.

This allows reading and writing concurrently from independent tasks.

Source

pub fn split_by_ref( &mut self, ) -> (&mut BufferedUarteRx<'d, U, T>, &mut BufferedUarteTx<'d, U>)

Split the UART in reader and writer parts, by reference.

The returned halves borrow from self, so you can drop them and go back to using the “un-split” self. This allows temporarily splitting the UART.

Source

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

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

Source

pub async fn fill_buf(&mut self) -> Result<&[u8], Error>

Return the contents of the internal buffer, filling it with more data from the inner reader if it is empty.

Source

pub fn consume(&mut self, amt: usize)

Tell this buffer that amt bytes have been consumed from the buffer, so they should no longer be returned in calls to fill_buf.

Source

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

Write a buffer into this writer, returning how many bytes were written.

Source

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

Try writing a buffer without waiting, returning how many bytes were written.

Source

pub async fn flush(&mut self) -> Result<(), Error>

Flush this output stream, ensuring that all intermediately buffered contents reach their destination.

Trait Implementations§

Source§

impl<'d, U: UarteInstance, T: TimerInstance> BufRead for BufferedUarte<'d, U, T>

Source§

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

Return the contents of the internal buffer, filling it with more data from the inner reader if it is empty. Read more
Source§

fn consume(&mut self, amt: usize)

Tell this buffer that amt bytes have been consumed from the buffer, so they should no longer be returned in calls to fill_buf.
Source§

impl<'d, U: UarteInstance, T: TimerInstance> ErrorType for BufferedUarte<'d, U, T>

Source§

type Error = Error

Error type of all the IO operations on this type.
Source§

impl<'d, U: UarteInstance, T: TimerInstance> Read for BufferedUarte<'d, U, T>

Source§

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. Read more
Source§

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

Read the exact number of bytes required to fill buf. Read more
Source§

impl<'d, U: UarteInstance, T: TimerInstance + 'd> ReadReady for BufferedUarte<'d, U, T>

Source§

fn read_ready(&mut self) -> Result<bool, Self::Error>

Get whether the reader is ready for immediately reading. Read more
Source§

impl<'d, U: UarteInstance, T: TimerInstance> Write for BufferedUarte<'d, U, T>

Source§

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

Write a buffer into this writer, returning how many bytes were written. Read more
Source§

async fn flush(&mut self) -> Result<(), Self::Error>

Flush this output stream, ensuring that all intermediately buffered contents reach their destination.
Source§

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

Write an entire buffer into this writer. Read more
Source§

impl<'d, U: UarteInstance, T: TimerInstance> Unpin for BufferedUarte<'d, U, T>

Auto Trait Implementations§

§

impl<'d, U, T> Freeze for BufferedUarte<'d, U, T>
where U: Freeze, T: Freeze,

§

impl<'d, U, T> RefUnwindSafe for BufferedUarte<'d, U, T>

§

impl<'d, U, T> Send for BufferedUarte<'d, U, T>

§

impl<'d, U, T> !Sync for BufferedUarte<'d, U, T>

§

impl<'d, U, T> !UnwindSafe for BufferedUarte<'d, U, T>

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

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<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.