use embedded_io::{ErrorKind, ErrorType};
use embedded_io_async::{Read, Write};
#[cfg(feature = "nusb")]
use crate::transport::nusb::{UsbError, UsbTransport};
#[cfg(all(feature = "rusb", not(feature = "nusb")))]
use crate::transport::rusb::{UsbError, UsbTransport};
use crate::transport::Splittable;
pub enum Transport<T> {
Tcp(T),
#[cfg(feature = "_usb")]
Usb(UsbTransport),
}
#[derive(Debug)]
pub enum TransportError<E> {
Tcp(E),
#[cfg(feature = "_usb")]
Usb(UsbError),
}
impl<E: core::fmt::Display> core::fmt::Display for TransportError<E> {
fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
match self {
Self::Tcp(e) => write!(f, "tcp: {e}"),
#[cfg(feature = "_usb")]
Self::Usb(e) => write!(f, "usb: {e}"),
}
}
}
impl<E> core::error::Error for TransportError<E>
where
E: core::error::Error + 'static,
{
fn source(&self) -> Option<&(dyn core::error::Error + 'static)> {
match self {
Self::Tcp(e) => Some(e),
#[cfg(feature = "_usb")]
Self::Usb(e) => Some(e),
}
}
}
impl<E: embedded_io::Error> embedded_io::Error for TransportError<E> {
fn kind(&self) -> ErrorKind {
match self {
Self::Tcp(e) => embedded_io::Error::kind(e),
#[cfg(feature = "_usb")]
Self::Usb(e) => embedded_io::Error::kind(e),
}
}
}
impl<T: ErrorType> ErrorType for Transport<T> {
type Error = TransportError<T::Error>;
}
impl<T: Read> Read for Transport<T> {
async fn read(&mut self, buf: &mut [u8]) -> Result<usize, Self::Error> {
match self {
Self::Tcp(t) => Read::read(t, buf).await.map_err(TransportError::Tcp),
#[cfg(feature = "_usb")]
Self::Usb(t) => Read::read(t, buf).await.map_err(TransportError::Usb),
}
}
}
impl<T: Write> Write for Transport<T> {
async fn write(&mut self, buf: &[u8]) -> Result<usize, Self::Error> {
match self {
Self::Tcp(t) => Write::write(t, buf).await.map_err(TransportError::Tcp),
#[cfg(feature = "_usb")]
Self::Usb(t) => Write::write(t, buf).await.map_err(TransportError::Usb),
}
}
async fn flush(&mut self) -> Result<(), Self::Error> {
match self {
Self::Tcp(t) => Write::flush(t).await.map_err(TransportError::Tcp),
#[cfg(feature = "_usb")]
Self::Usb(t) => Write::flush(t).await.map_err(TransportError::Usb),
}
}
}
impl<T: Splittable> Splittable for Transport<T> {
type ReadHalf = Transport<T::ReadHalf>;
type WriteHalf = Transport<T::WriteHalf>;
fn split(self) -> Result<(Self::ReadHalf, Self::WriteHalf), Self::Error> {
match self {
Self::Tcp(t) => {
let (r, w) = t.split().map_err(TransportError::Tcp)?;
Ok((Transport::Tcp(r), Transport::Tcp(w)))
}
#[cfg(feature = "_usb")]
Self::Usb(t) => {
let (r, w) = t.split().map_err(TransportError::Usb)?;
Ok((Transport::Usb(r), Transport::Usb(w)))
}
}
}
}
#[cfg(test)]
mod tests {
use super::{Transport, TransportError};
use crate::transport::Splittable;
use alloc::format;
use core::future::Future;
use core::pin::pin;
use core::task::{Context, Poll, Waker};
use embedded_io::{ErrorKind, ErrorType};
use embedded_io_async::{Read, Write};
fn poll_ready<F: Future>(fut: F) -> F::Output {
let mut cx = Context::from_waker(Waker::noop());
let mut fut = pin!(fut);
match fut.as_mut().poll(&mut cx) {
Poll::Ready(v) => v,
Poll::Pending => panic!("mock future returned Pending"),
}
}
#[derive(Debug, Clone, PartialEq, Eq)]
struct MockErr(&'static str);
impl embedded_io::Error for MockErr {
fn kind(&self) -> ErrorKind {
ErrorKind::InvalidData
}
}
impl core::fmt::Display for MockErr {
fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
f.write_str(self.0)
}
}
#[derive(Default)]
struct MockIo {
read_result: Option<Result<&'static [u8], MockErr>>,
write_result: Option<Result<usize, MockErr>>,
flush_result: Option<Result<(), MockErr>>,
split_err: Option<MockErr>,
}
impl ErrorType for MockIo {
type Error = MockErr;
}
impl Read for MockIo {
async fn read(&mut self, buf: &mut [u8]) -> Result<usize, MockErr> {
match self.read_result.take().expect("read_result not set") {
Ok(data) => {
let n = data.len().min(buf.len());
buf[..n].copy_from_slice(&data[..n]);
Ok(n)
}
Err(e) => Err(e),
}
}
}
impl Write for MockIo {
async fn write(&mut self, _buf: &[u8]) -> Result<usize, MockErr> {
self.write_result.take().expect("write_result not set")
}
async fn flush(&mut self) -> Result<(), MockErr> {
self.flush_result.take().expect("flush_result not set")
}
}
impl Splittable for MockIo {
type ReadHalf = MockIo;
type WriteHalf = MockIo;
fn split(self) -> Result<(Self::ReadHalf, Self::WriteHalf), MockErr> {
if let Some(e) = self.split_err {
Err(e)
} else {
Ok((MockIo::default(), MockIo::default()))
}
}
}
#[test]
fn transport_error_tcp_display_prefixes_inner_with_tcp() {
let e: TransportError<MockErr> = TransportError::Tcp(MockErr("oops"));
assert_eq!(format!("{}", e), "tcp: oops");
}
#[test]
fn transport_error_tcp_kind_delegates_to_inner() {
let e: TransportError<MockErr> = TransportError::Tcp(MockErr("x"));
assert_eq!(embedded_io::Error::kind(&e), ErrorKind::InvalidData);
}
#[test]
fn transport_tcp_read_delegates_and_returns_byte_count() {
let inner = MockIo {
read_result: Some(Ok(b"hello")),
..MockIo::default()
};
let mut t: Transport<MockIo> = Transport::Tcp(inner);
let mut buf = [0u8; 8];
let n = poll_ready(t.read(&mut buf)).unwrap();
assert_eq!(n, 5);
assert_eq!(&buf[..n], b"hello");
}
#[test]
fn transport_tcp_read_wraps_inner_error_as_tcp_variant() {
let inner = MockIo {
read_result: Some(Err(MockErr("broken"))),
..MockIo::default()
};
let mut t: Transport<MockIo> = Transport::Tcp(inner);
let mut buf = [0u8; 8];
let err = poll_ready(t.read(&mut buf)).unwrap_err();
assert!(matches!(err, TransportError::Tcp(MockErr("broken"))));
}
#[test]
fn transport_tcp_write_delegates_and_returns_byte_count() {
let inner = MockIo {
write_result: Some(Ok(3)),
..MockIo::default()
};
let mut t: Transport<MockIo> = Transport::Tcp(inner);
let n = poll_ready(t.write(b"abc")).unwrap();
assert_eq!(n, 3);
}
#[test]
fn transport_tcp_write_wraps_inner_error_as_tcp_variant() {
let inner = MockIo {
write_result: Some(Err(MockErr("nope"))),
..MockIo::default()
};
let mut t: Transport<MockIo> = Transport::Tcp(inner);
let err = poll_ready(t.write(b"x")).unwrap_err();
assert!(matches!(err, TransportError::Tcp(MockErr("nope"))));
}
#[test]
fn transport_tcp_flush_delegates_to_inner() {
let inner = MockIo {
flush_result: Some(Ok(())),
..MockIo::default()
};
let mut t: Transport<MockIo> = Transport::Tcp(inner);
poll_ready(t.flush()).unwrap();
}
#[test]
fn transport_tcp_flush_wraps_inner_error_as_tcp_variant() {
let inner = MockIo {
flush_result: Some(Err(MockErr("flush-fail"))),
..MockIo::default()
};
let mut t: Transport<MockIo> = Transport::Tcp(inner);
let err = poll_ready(t.flush()).unwrap_err();
assert!(matches!(err, TransportError::Tcp(MockErr("flush-fail"))));
}
#[test]
fn transport_tcp_split_wraps_halves_as_tcp_variants() {
let t: Transport<MockIo> = Transport::Tcp(MockIo::default());
let (r, w) = t.split().expect("split ok");
assert!(matches!(r, Transport::Tcp(_)));
assert!(matches!(w, Transport::Tcp(_)));
}
#[test]
fn transport_tcp_split_wraps_inner_error_as_tcp_variant() {
let inner = MockIo {
split_err: Some(MockErr("split-fail")),
..MockIo::default()
};
let t: Transport<MockIo> = Transport::Tcp(inner);
match t.split() {
Ok(_) => panic!("expected split to fail"),
Err(TransportError::Tcp(MockErr("split-fail"))) => {}
#[allow(unreachable_patterns)]
Err(other) => panic!("wrong variant: {other:?}"),
}
}
}