Add async API for CAN

embedded-can/CHANGELOG.md

@@ -7,7 +7,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 
 ## [Unreleased]
 
-...
+- Add async API.
 
 ## [v0.4.1] - 2022-09-28
 

embedded-can/src/asynch.rs

@@ -0,0 +1,17 @@
+//! Async CAN API
+
+/// An async CAN interface that is able to transmit and receive frames.
+pub trait Can {
+    /// Associated frame type.
+    type Frame: crate::Frame;
+
+    /// Associated error type.
+    type Error: crate::Error;
+
+    /// Puts a frame in the transmit buffer.
+    /// Awaits until space is available in the transmit buffer.
+    async fn transmit(&mut self, frame: &Self::Frame) -> Result<(), Self::Error>;
+
+    /// Awaits until a frame was received or an error occurred.
+    async fn receive(&mut self) -> Result<Self::Frame, Self::Error>;
+}

embedded-can/src/lib.rs

@@ -2,7 +2,15 @@
 
 #![warn(missing_docs)]
 #![no_std]
-
+// disable warning for already-stabilized features.
+// Needed to pass CI, because we deny warnings.
+// We don't immediately remove them to not immediately break older nightlies.
+// When all features are stable, we'll remove them.
+#![cfg_attr(nightly, allow(stable_features, unknown_lints))]
+#![cfg_attr(nightly, feature(async_fn_in_trait, impl_trait_projections))]
+#![allow(async_fn_in_trait)]
+
+pub mod asynch;
 pub mod blocking;
 pub mod nb;