//! HAL interface to the UARTE peripheral //! //! See product specification: //! //! - nrf52832: Section 35 //! - nrf52840: Section 6.34 use core::cmp::min; use core::mem; use core::ops::Deref; use core::pin::Pin; use core::sync::atomic::{compiler_fence, Ordering}; use core::task::{Context, Poll}; use embassy::io::{AsyncBufRead, AsyncWrite, Result}; use embassy::util::WakerRegistration; use embedded_hal::digital::v2::OutputPin; use crate::fmt::{panic, todo, *}; use crate::hal::gpio::Port as GpioPort; use crate::interrupt::{self, OwnedInterrupt}; use crate::pac; use crate::pac::uarte0; use crate::util::peripheral::{PeripheralMutex, PeripheralState}; use crate::util::ring_buffer::RingBuffer; // Re-export SVD variants to allow user to directly set values pub use crate::hal::uarte::Pins; pub use uarte0::{baudrate::BAUDRATE_A as Baudrate, config::PARITY_A as Parity}; #[derive(Copy, Clone, Debug, PartialEq)] enum RxState { Idle, Receiving, ReceivingReady, Stopping, } #[derive(Copy, Clone, Debug, PartialEq)] enum TxState { Idle, Transmitting(usize), } struct State<'a, U: Instance> { inner: U, rx: RingBuffer<'a>, rx_state: RxState, rx_waker: WakerRegistration, tx: RingBuffer<'a>, tx_state: TxState, tx_waker: WakerRegistration, } /// Interface to a UARTE instance /// /// This is a very basic interface that comes with the following limitations: /// - The UARTE instances share the same address space with instances of UART. /// You need to make sure that conflicting instances /// are disabled before using `Uarte`. See product specification: /// - nrf52832: Section 15.2 /// - nrf52840: Section 6.1.2 pub struct BufferedUarte<'a, U: Instance> { inner: PeripheralMutex>, } impl<'a, U: Instance> Unpin for BufferedUarte<'a, U> {} #[cfg(any(feature = "52833", feature = "52840"))] fn port_bit(port: GpioPort) -> bool { match port { GpioPort::Port0 => false, GpioPort::Port1 => true, } } impl<'a, U: Instance> BufferedUarte<'a, U> { pub fn new( uarte: U, irq: U::Interrupt, rx_buffer: &'a mut [u8], tx_buffer: &'a mut [u8], mut pins: Pins, parity: Parity, baudrate: Baudrate, ) -> Self { // Select pins uarte.psel.rxd.write(|w| { let w = unsafe { w.pin().bits(pins.rxd.pin()) }; #[cfg(any(feature = "52833", feature = "52840"))] let w = w.port().bit(port_bit(pins.rxd.port())); w.connect().connected() }); pins.txd.set_high().unwrap(); uarte.psel.txd.write(|w| { let w = unsafe { w.pin().bits(pins.txd.pin()) }; #[cfg(any(feature = "52833", feature = "52840"))] let w = w.port().bit(port_bit(pins.txd.port())); w.connect().connected() }); // Optional pins uarte.psel.cts.write(|w| { if let Some(ref pin) = pins.cts { let w = unsafe { w.pin().bits(pin.pin()) }; #[cfg(any(feature = "52833", feature = "52840"))] let w = w.port().bit(port_bit(pin.port())); w.connect().connected() } else { w.connect().disconnected() } }); uarte.psel.rts.write(|w| { if let Some(ref pin) = pins.rts { let w = unsafe { w.pin().bits(pin.pin()) }; #[cfg(any(feature = "52833", feature = "52840"))] let w = w.port().bit(port_bit(pin.port())); w.connect().connected() } else { w.connect().disconnected() } }); // Enable UARTE instance uarte.enable.write(|w| w.enable().enabled()); // Enable interrupts uarte.intenset.write(|w| w.endrx().set().endtx().set()); // Configure let hardware_flow_control = pins.rts.is_some() && pins.cts.is_some(); uarte .config .write(|w| w.hwfc().bit(hardware_flow_control).parity().variant(parity)); // Configure frequency uarte.baudrate.write(|w| w.baudrate().variant(baudrate)); // Disable the irq, let the Registration enable it when everything is set up. irq.disable(); irq.pend(); BufferedUarte { inner: PeripheralMutex::new( State { inner: uarte, rx: RingBuffer::new(rx_buffer), rx_state: RxState::Idle, rx_waker: WakerRegistration::new(), tx: RingBuffer::new(tx_buffer), tx_state: TxState::Idle, tx_waker: WakerRegistration::new(), }, irq, ), } } fn inner(self: Pin<&mut Self>) -> Pin<&mut PeripheralMutex>> { unsafe { Pin::new_unchecked(&mut self.get_unchecked_mut().inner) } } } impl<'a, U: Instance> Drop for BufferedUarte<'a, U> { fn drop(&mut self) { // stop DMA before dropping, because DMA is using the buffer in `self`. todo!() } } impl<'a, U: Instance> AsyncBufRead for BufferedUarte<'a, U> { fn poll_fill_buf(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll> { self.inner().with(|state, _irq| { // Conservative compiler fence to prevent optimizations that do not // take in to account actions by DMA. The fence has been placed here, // before any DMA action has started compiler_fence(Ordering::SeqCst); trace!("poll_read"); // We have data ready in buffer? Return it. let buf = state.rx.pop_buf(); if buf.len() != 0 { trace!(" got {:?} {:?}", buf.as_ptr() as u32, buf.len()); let buf: &[u8] = buf; let buf: &[u8] = unsafe { mem::transmute(buf) }; return Poll::Ready(Ok(buf)); } trace!(" empty"); if state.rx_state == RxState::ReceivingReady { trace!(" stopping"); state.rx_state = RxState::Stopping; state.inner.tasks_stoprx.write(|w| unsafe { w.bits(1) }); } state.rx_waker.register(cx.waker()); Poll::>::Pending }) } fn consume(self: Pin<&mut Self>, amt: usize) { self.inner().with(|state, irq| { trace!("consume {:?}", amt); state.rx.pop(amt); irq.pend(); }) } } impl<'a, U: Instance> AsyncWrite for BufferedUarte<'a, U> { fn poll_write(self: Pin<&mut Self>, cx: &mut Context<'_>, buf: &[u8]) -> Poll> { self.inner().with(|state, irq| { trace!("poll_write: {:?}", buf.len()); let tx_buf = state.tx.push_buf(); if tx_buf.len() == 0 { trace!("poll_write: pending"); state.tx_waker.register(cx.waker()); return Poll::Pending; } let n = min(tx_buf.len(), buf.len()); tx_buf[..n].copy_from_slice(&buf[..n]); state.tx.push(n); trace!("poll_write: queued {:?}", n); // Conservative compiler fence to prevent optimizations that do not // take in to account actions by DMA. The fence has been placed here, // before any DMA action has started compiler_fence(Ordering::SeqCst); irq.pend(); Poll::Ready(Ok(n)) }) } } impl<'a, U: Instance> PeripheralState for State<'a, U> { type Interrupt = U::Interrupt; fn on_interrupt(&mut self) { trace!("irq: start"); let mut more_work = true; while more_work { more_work = false; match self.rx_state { RxState::Idle => { trace!(" irq_rx: in state idle"); if self.inner.events_rxdrdy.read().bits() != 0 { trace!(" irq_rx: rxdrdy?????"); self.inner.events_rxdrdy.reset(); } if self.inner.events_endrx.read().bits() != 0 { panic!("unexpected endrx"); } let buf = self.rx.push_buf(); if buf.len() != 0 { trace!(" irq_rx: starting {:?}", buf.len()); self.rx_state = RxState::Receiving; // Set up the DMA read self.inner.rxd.ptr.write(|w| // The PTR field is a full 32 bits wide and accepts the full range // of values. unsafe { w.ptr().bits(buf.as_ptr() as u32) }); self.inner.rxd.maxcnt.write(|w| // We're giving it the length of the buffer, so no danger of // accessing invalid memory. We have verified that the length of the // buffer fits in an `u8`, so the cast to `u8` is also fine. // // The MAXCNT field is at least 8 bits wide and accepts the full // range of values. unsafe { w.maxcnt().bits(buf.len() as _) }); trace!(" irq_rx: buf {:?} {:?}", buf.as_ptr() as u32, buf.len()); // Enable RXRDY interrupt. self.inner.events_rxdrdy.reset(); self.inner.intenset.write(|w| w.rxdrdy().set()); // Start UARTE Receive transaction self.inner.tasks_startrx.write(|w| // `1` is a valid value to write to task registers. unsafe { w.bits(1) }); } } RxState::Receiving => { trace!(" irq_rx: in state receiving"); if self.inner.events_rxdrdy.read().bits() != 0 { trace!(" irq_rx: rxdrdy"); // Disable the RXRDY event interrupt // RXRDY is triggered for every byte, but we only care about whether we have // some bytes or not. So as soon as we have at least one, disable it, to avoid // wasting CPU cycles in interrupts. self.inner.intenclr.write(|w| w.rxdrdy().clear()); self.inner.events_rxdrdy.reset(); self.rx_waker.wake(); self.rx_state = RxState::ReceivingReady; more_work = true; // in case we also have endrx pending } } RxState::ReceivingReady | RxState::Stopping => { trace!(" irq_rx: in state ReceivingReady"); if self.inner.events_rxdrdy.read().bits() != 0 { trace!(" irq_rx: rxdrdy"); self.inner.events_rxdrdy.reset(); } if self.inner.events_endrx.read().bits() != 0 { let n: usize = self.inner.rxd.amount.read().amount().bits() as usize; trace!(" irq_rx: endrx {:?}", n); self.rx.push(n); self.inner.events_endrx.reset(); self.rx_waker.wake(); self.rx_state = RxState::Idle; more_work = true; // start another rx if possible } } } } more_work = true; while more_work { more_work = false; match self.tx_state { TxState::Idle => { trace!(" irq_tx: in state Idle"); let buf = self.tx.pop_buf(); if buf.len() != 0 { trace!(" irq_tx: starting {:?}", buf.len()); self.tx_state = TxState::Transmitting(buf.len()); // Set up the DMA write self.inner.txd.ptr.write(|w| // The PTR field is a full 32 bits wide and accepts the full range // of values. unsafe { w.ptr().bits(buf.as_ptr() as u32) }); self.inner.txd.maxcnt.write(|w| // We're giving it the length of the buffer, so no danger of // accessing invalid memory. We have verified that the length of the // buffer fits in an `u8`, so the cast to `u8` is also fine. // // The MAXCNT field is 8 bits wide and accepts the full range of // values. unsafe { w.maxcnt().bits(buf.len() as _) }); // Start UARTE Transmit transaction self.inner.tasks_starttx.write(|w| // `1` is a valid value to write to task registers. unsafe { w.bits(1) }); } } TxState::Transmitting(n) => { trace!(" irq_tx: in state Transmitting"); if self.inner.events_endtx.read().bits() != 0 { self.inner.events_endtx.reset(); trace!(" irq_tx: endtx {:?}", n); self.tx.pop(n); self.tx_waker.wake(); self.tx_state = TxState::Idle; more_work = true; // start another tx if possible } } } } trace!("irq: end"); } } mod sealed { pub trait Instance {} impl Instance for crate::pac::UARTE0 {} #[cfg(any(feature = "52833", feature = "52840", feature = "9160"))] impl Instance for crate::pac::UARTE1 {} } pub trait Instance: Deref + sealed::Instance { type Interrupt: OwnedInterrupt; } impl Instance for pac::UARTE0 { type Interrupt = interrupt::UARTE0_UART0Interrupt; } #[cfg(any(feature = "52833", feature = "52840", feature = "9160"))] impl Instance for pac::UARTE1 { type Interrupt = interrupt::UARTE1Interrupt; }