Add async API for CAN

embedded-can/CHANGELOG.md

@@ -15,6 +15,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 ### Added
 
 - `as_raw_unchecked` getter function for `Id`
+- Add async API.
 
 ## [v0.4.1] - 2022-09-28
 

embedded-can/src/asynch.rs

@@ -0,0 +1,28 @@
+//! Async CAN API
+
+use core::future::Future;
+
+/// An async CAN interface that is able to transmit frames.
+pub trait CanTx {
+    /// Associated frame type.
+    type Frame: crate::Frame;
+
+    /// Associated error type.
+    type Error: crate::Error;
+
+    /// Puts a frame in the transmit buffer or awaits until space is available
+    /// in the transmit buffer.
+    fn transmit(&mut self, frame: &Self::Frame) -> impl Future<Output = Result<(), Self::Error>>;
+}
+
+/// An async CAN interface that is able to receive frames.
+pub trait CanRx {
+    /// Associated frame type.
+    type Frame: crate::Frame;
+
+    /// Associated error type.
+    type Error: crate::Error;
+
+    /// Awaits until a frame was received or an error occurs.
+    fn receive(&mut self) -> impl Future<Output = Result<Self::Frame, Self::Error>>;
+}

embedded-can/src/lib.rs

@@ -3,6 +3,7 @@
 #![warn(missing_docs)]
 #![no_std]
 
+pub mod asynch;
 pub mod blocking;
 pub mod nb;