diff --git a/embassy-net/Cargo.toml b/embassy-net/Cargo.toml
index be9f1d784..ee7289ad8 100644
--- a/embassy-net/Cargo.toml
+++ b/embassy-net/Cargo.toml
@@ -16,11 +16,11 @@ categories = [
[package.metadata.embassy_docs]
src_base = "https://github.com/embassy-rs/embassy/blob/embassy-net-v$VERSION/embassy-net/src/"
src_base_git = "https://github.com/embassy-rs/embassy/blob/$COMMIT/embassy-net/src/"
-features = ["defmt", "tcp", "udp", "dns", "dhcpv4", "proto-ipv6", "medium-ethernet", "medium-ip", "medium-ieee802154", "igmp", "dhcpv4-hostname"]
+features = ["defmt", "tcp", "udp", "raw", "dns", "dhcpv4", "proto-ipv6", "medium-ethernet", "medium-ip", "medium-ieee802154", "igmp", "dhcpv4-hostname"]
target = "thumbv7em-none-eabi"
[package.metadata.docs.rs]
-features = ["defmt", "tcp", "udp", "dns", "dhcpv4", "proto-ipv6", "medium-ethernet", "medium-ip", "medium-ieee802154", "igmp", "dhcpv4-hostname"]
+features = ["defmt", "tcp", "udp", "raw", "dns", "dhcpv4", "proto-ipv6", "medium-ethernet", "medium-ip", "medium-ieee802154", "igmp", "dhcpv4-hostname"]
[features]
default = []
@@ -38,6 +38,8 @@ packet-trace = []
## Enable UDP support
udp = ["smoltcp/socket-udp"]
+## Enable Raw support
+raw = ["smoltcp/socket-raw"]
## Enable TCP support
tcp = ["smoltcp/socket-tcp"]
## Enable DNS support
diff --git a/embassy-net/src/lib.rs b/embassy-net/src/lib.rs
index 1c0cf1a12..86ced1ded 100644
--- a/embassy-net/src/lib.rs
+++ b/embassy-net/src/lib.rs
@@ -15,6 +15,8 @@ pub(crate) mod fmt;
mod device;
#[cfg(feature = "dns")]
pub mod dns;
+#[cfg(feature = "raw")]
+pub mod raw;
#[cfg(feature = "tcp")]
pub mod tcp;
mod time;
diff --git a/embassy-net/src/raw.rs b/embassy-net/src/raw.rs
new file mode 100644
index 000000000..7ecd913e7
--- /dev/null
+++ b/embassy-net/src/raw.rs
@@ -0,0 +1,120 @@
+//! Raw sockets.
+
+use core::cell::RefCell;
+use core::future::poll_fn;
+use core::mem;
+use core::task::{Context, Poll};
+
+use embassy_net_driver::Driver;
+use smoltcp::iface::{Interface, SocketHandle};
+use smoltcp::socket::raw;
+pub use smoltcp::socket::raw::PacketMetadata;
+use smoltcp::wire::{IpProtocol, IpVersion};
+
+use crate::{SocketStack, Stack};
+
+/// Error returned by [`RawSocket::recv`] and [`RawSocket::send`].
+#[derive(PartialEq, Eq, Clone, Copy, Debug)]
+#[cfg_attr(feature = "defmt", derive(defmt::Format))]
+pub enum RecvError {
+ /// Provided buffer was smaller than the received packet.
+ Truncated,
+}
+
+/// An Raw socket.
+pub struct RawSocket<'a> {
+ stack: &'a RefCell<SocketStack>,
+ handle: SocketHandle,
+}
+
+impl<'a> RawSocket<'a> {
+ /// Create a new Raw socket using the provided stack and buffers.
+ pub fn new<D: Driver>(
+ stack: &'a Stack<D>,
+ ip_version: IpVersion,
+ ip_protocol: IpProtocol,
+ rx_meta: &'a mut [PacketMetadata],
+ rx_buffer: &'a mut [u8],
+ tx_meta: &'a mut [PacketMetadata],
+ tx_buffer: &'a mut [u8],
+ ) -> Self {
+ let s = &mut *stack.socket.borrow_mut();
+
+ let rx_meta: &'static mut [PacketMetadata] = unsafe { mem::transmute(rx_meta) };
+ let rx_buffer: &'static mut [u8] = unsafe { mem::transmute(rx_buffer) };
+ let tx_meta: &'static mut [PacketMetadata] = unsafe { mem::transmute(tx_meta) };
+ let tx_buffer: &'static mut [u8] = unsafe { mem::transmute(tx_buffer) };
+ let handle = s.sockets.add(raw::Socket::new(
+ ip_version,
+ ip_protocol,
+ raw::PacketBuffer::new(rx_meta, rx_buffer),
+ raw::PacketBuffer::new(tx_meta, tx_buffer),
+ ));
+
+ Self {
+ stack: &stack.socket,
+ handle,
+ }
+ }
+
+ fn with_mut<R>(&self, f: impl FnOnce(&mut raw::Socket, &mut Interface) -> R) -> R {
+ let s = &mut *self.stack.borrow_mut();
+ let socket = s.sockets.get_mut::<raw::Socket>(self.handle);
+ let res = f(socket, &mut s.iface);
+ s.waker.wake();
+ res
+ }
+
+ /// Receive a datagram.
+ ///
+ /// This method will wait until a datagram is received.
+ pub async fn recv(&self, buf: &mut [u8]) -> Result<usize, RecvError> {
+ poll_fn(move |cx| self.poll_recv(buf, cx)).await
+ }
+
+ /// Receive a datagram.
+ ///
+ /// When no datagram is available, this method will return `Poll::Pending` and
+ /// register the current task to be notified when a datagram is received.
+ pub fn poll_recv(&self, buf: &mut [u8], cx: &mut Context<'_>) -> Poll<Result<usize, RecvError>> {
+ self.with_mut(|s, _| match s.recv_slice(buf) {
+ Ok(n) => Poll::Ready(Ok(n)),
+ // No data ready
+ Err(raw::RecvError::Truncated) => Poll::Ready(Err(RecvError::Truncated)),
+ Err(raw::RecvError::Exhausted) => {
+ s.register_recv_waker(cx.waker());
+ Poll::Pending
+ }
+ })
+ }
+
+ /// Send a datagram.
+ ///
+ /// This method will wait until the datagram has been sent.`
+ pub async fn send(&self, buf: &[u8]) {
+ poll_fn(move |cx| self.poll_send(buf, cx)).await
+ }
+
+ /// Send a datagram.
+ ///
+ /// When the datagram has been sent, this method will return `Poll::Ready(Ok())`.
+ ///
+ /// When the socket's send buffer is full, this method will return `Poll::Pending`
+ /// and register the current task to be notified when the buffer has space available.
+ pub fn poll_send(&self, buf: &[u8], cx: &mut Context<'_>) -> Poll<()> {
+ self.with_mut(|s, _| match s.send_slice(buf) {
+ // Entire datagram has been sent
+ Ok(()) => Poll::Ready(()),
+ Err(raw::SendError::BufferFull) => {
+ s.register_send_waker(cx.waker());
+ Poll::Pending
+ }
+ })
+ }
+}
+
+impl Drop for RawSocket<'_> {
+ fn drop(&mut self) {
+ self.stack.borrow_mut().sockets.remove(self.handle);
+ }
+}
diff --git a/examples/rp/Cargo.toml b/examples/rp/Cargo.toml
index 585349506..0f58f143c 100644
--- a/examples/rp/Cargo.toml
+++ b/examples/rp/Cargo.toml
@@ -12,7 +12,7 @@ embassy-executor = { version = "0.5.0", path = "../../embassy-executor", feature
embassy-time = { version = "0.3.0", path = "../../embassy-time", features = ["defmt", "defmt-timestamp-uptime"] }
embassy-rp = { version = "0.1.0", path = "../../embassy-rp", features = ["defmt", "unstable-pac", "time-driver", "critical-section-impl"] }
embassy-usb = { version = "0.1.0", path = "../../embassy-usb", features = ["defmt"] }
-embassy-net = { version = "0.4.0", path = "../../embassy-net", features = ["defmt", "tcp", "udp", "dhcpv4", "medium-ethernet"] }
+embassy-net = { version = "0.4.0", path = "../../embassy-net", features = ["defmt", "tcp", "udp", "raw", "dhcpv4", "medium-ethernet"] }
embassy-net-wiznet = { version = "0.1.0", path = "../../embassy-net-wiznet", features = ["defmt"] }
embassy-futures = { version = "0.1.0", path = "../../embassy-futures" }
embassy-usb-logger = { version = "0.1.0", path = "../../embassy-usb-logger" }