Move traits to separate crate.

4 files changed, 124 insertions, 0 deletions

diff --git a/embassy-traits/src/flash.rs b/embassy-traits/src/flash.rs
new file mode 100644
index 000000000..145cc7684
--- /dev/null
+++ b/embassy-traits/src/flash.rs
@@ -0,0 +1,51 @@
+use core::future::Future;
+use core::pin::Pin;
+
+#[derive(Copy, Clone, Debug, Eq, PartialEq)]
+#[cfg_attr(feature = "defmt", derive(defmt::Format))]
+#[non_exhaustive]
+pub enum Error {
+    Failed,
+    AddressMisaligned,
+    BufferMisaligned,
+}
+
+pub trait Flash {
+    type ReadFuture<'a>: Future<Output = Result<(), Error>>;
+    type WriteFuture<'a>: Future<Output = Result<(), Error>>;
+    type ErasePageFuture<'a>: Future<Output = Result<(), Error>>;
+
+    /// Reads data from the flash device.
+    ///
+    /// address must be a multiple of self.read_size().
+    /// buf.len() must be a multiple of self.read_size().
+    fn read<'a>(self: Pin<&'a mut Self>, address: usize, buf: &'a mut [u8])
+        -> Self::ReadFuture<'a>;
+
+    /// Writes data to the flash device.
+    ///
+    /// address must be a multiple of self.write_size().
+    /// buf.len() must be a multiple of self.write_size().
+    fn write<'a>(self: Pin<&'a mut Self>, address: usize, buf: &'a [u8]) -> Self::WriteFuture<'a>;
+
+    /// Erases a single page from the flash device.
+    ///
+    /// address must be a multiple of self.erase_size().
+    fn erase<'a>(self: Pin<&'a mut Self>, address: usize) -> Self::ErasePageFuture<'a>;
+
+    /// Returns the total size, in bytes.
+    /// This is not guaranteed to be a power of 2.
+    fn size(&self) -> usize;
+
+    /// Returns the read size in bytes.
+    /// This is guaranteed to be a power of 2.
+    fn read_size(&self) -> usize;
+
+    /// Returns the write size in bytes.
+    /// This is guaranteed to be a power of 2.
+    fn write_size(&self) -> usize;
+
+    /// Returns the erase size in bytes.
+    /// This is guaranteed to be a power of 2.
+    fn erase_size(&self) -> usize;
+}
diff --git a/embassy-traits/src/gpio.rs b/embassy-traits/src/gpio.rs
new file mode 100644
index 000000000..4c3feac21
--- /dev/null
+++ b/embassy-traits/src/gpio.rs
@@ -0,0 +1,48 @@
+use core::future::Future;
+use core::pin::Pin;
+
+/// Wait for a pin to become high.
+pub trait WaitForHigh {
+    type Future<'a>: Future<Output = ()> + 'a;
+
+    /// Wait for a pin to become high.
+    ///
+    /// If the pin is already high, the future completes immediately.
+    /// Otherwise, it completes when it becomes high.
+    fn wait_for_high<'a>(self: Pin<&'a mut Self>) -> Self::Future<'a>;
+}
+
+/// Wait for a pin to become low.
+pub trait WaitForLow {
+    type Future<'a>: Future<Output = ()> + 'a;
+
+    /// Wait for a pin to become low.
+    ///
+    /// If the pin is already low, the future completes immediately.
+    /// Otherwise, it completes when it becomes low.
+    fn wait_for_low<'a>(self: Pin<&'a mut Self>) -> Self::Future<'a>;
+}
+
+/// Wait for a rising edge (transition from low to high)
+pub trait WaitForRisingEdge {
+    type Future<'a>: Future<Output = ()> + 'a;
+
+    /// Wait for a rising edge (transition from low to high)
+    fn wait_for_rising_edge<'a>(self: Pin<&'a mut Self>) -> Self::Future<'a>;
+}
+
+/// Wait for a falling edge (transition from high to low)
+pub trait WaitForFallingEdge {
+    type Future<'a>: Future<Output = ()> + 'a;
+
+    /// Wait for a falling edge (transition from high to low)
+    fn wait_for_falling_edge<'a>(self: Pin<&'a mut Self>) -> Self::Future<'a>;
+}
+
+/// Wait for any edge (any transition, high to low or low to high)
+pub trait WaitForAnyEdge {
+    type Future<'a>: Future<Output = ()> + 'a;
+
+    /// Wait for any edge (any transition, high to low or low to high)
+    fn wait_for_any_edge<'a>(self: Pin<&'a mut Self>) -> Self::Future<'a>;
+}
diff --git a/embassy-traits/src/lib.rs b/embassy-traits/src/lib.rs
new file mode 100644
index 000000000..55af46cff
--- /dev/null
+++ b/embassy-traits/src/lib.rs
@@ -0,0 +1,10 @@
+#![cfg_attr(not(feature = "std"), no_std)]
+#![feature(generic_associated_types)]
+#![feature(const_fn)]
+#![feature(const_fn_fn_ptr_basics)]
+#![feature(const_option)]
+#![allow(incomplete_features)]
+
+pub mod flash;
+pub mod gpio;
+pub mod uart;
diff --git a/embassy-traits/src/uart.rs b/embassy-traits/src/uart.rs
new file mode 100644
index 000000000..b40b9e9bd
--- /dev/null
+++ b/embassy-traits/src/uart.rs
@@ -0,0 +1,15 @@
+use core::future::Future;
+
+#[derive(Copy, Clone, Debug, Eq, PartialEq)]
+#[cfg_attr(feature = "defmt", derive(defmt::Format))]
+#[non_exhaustive]
+pub enum Error {
+    Other,
+}
+
+pub trait Uart {
+    type ReceiveFuture<'a>: Future<Output = Result<(), Error>>;
+    type SendFuture<'a>: Future<Output = Result<(), Error>>;
+    fn receive<'a>(&'a mut self, buf: &'a mut [u8]) -> Self::ReceiveFuture<'a>;
+    fn send<'a>(&'a mut self, buf: &'a [u8]) -> Self::SendFuture<'a>;
+}