Struct PioUart 

pub struct PioUart<RXID: PinId, TXID: PinId, PIO: PIOExt, State> { /* private fields */ }

Represents a UART interface using the RP2040’s PIO hardware.

Type Parameters

• RXID: The PinId for the RX pin.
• TXID: The PinId for the TX pin.
• PIO: The PIO instance, either pac::PIO0 or pac::PIO1.
• State: The state of the UART interface, either pio::Stopped or pio::Running.

Implementations

impl<RXID: PinId, TXID: PinId, PIO: PIOExt> PioUart<RXID, TXID, PIO, Stopped>

pub fn new( pio: PIO, rx_pin: Pin<RXID, <PIO as PIOExt>::PinFunction, PullUp>, tx_pin: Pin<TXID, <PIO as PIOExt>::PinFunction, PullNone>, resets: &mut RESETS, baud: HertzU32, system_freq: HertzU32, ) -> Self

Create a new PioUart instance. This method consumes the PIO instance and does not allow to use the other 2 state machines. If more control is required, use PioUartRx and PioUartTx individually.

Arguments

• pio: A PIO instance from the RP2040, either pac::PIO0 or pac::PIO1.
• rx_pin: The RX pin configured with FunctionPioX and PullUp. Use pin.gpioX.reconfigure().
• tx_pin: The TX pin configured with FunctionPioX and PullNone. Use pin.gpioX.reconfigure().
• resets: A mutable reference to the RP2040 resets.
• baud: Desired baud rate.
• system_freq: System frequency.

pub fn enable(self) -> PioUart<RXID, TXID, PIO, Running>

Enables the UART, transitioning it to the Running state.

Returns

An instance of PioUart in the Running state.

pub fn free( self, ) -> (PIO, Pin<RXID, <PIO as PIOExt>::PinFunction, PullUp>, Pin<TXID, <PIO as PIOExt>::PinFunction, PullNone>)

Frees the underlying resources, returning the PIO instance and pins. Also uninstalls the UART programs.

Returns

A tuple containing the PIO, RX pin, and TX pin.

Trait Implementations

impl<RXID: PinId, TXID: PinId, PIO: PIOExt> ErrorType for PioUart<RXID, TXID, PIO, Running>

type Error = PioSerialError

Error type of all the IO operations on this type.

impl<RXID: PinId, TXID: PinId, PIO: PIOExt> Read for PioUart<RXID, TXID, PIO, Running>

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<RXID: PinId, TXID: PinId, PIO: PIOExt> Write for PioUart<RXID, TXID, PIO, Running>

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

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

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

Flush this output stream, blocking until all intermediately buffered contents reach their destination.

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

Write an entire buffer into this writer.

fn write_fmt( &mut self, fmt: Arguments<'_>, ) -> Result<(), WriteFmtError<Self::Error>>

Write a formatted string into this writer, returning any error encountered.