10 unstable releases (4 breaking)
0.4.0 | Jan 2, 2025 |
---|---|
0.3.0 | Jun 5, 2024 |
0.2.0 | Oct 25, 2023 |
0.1.3 | Jul 25, 2022 |
0.0.1 | Sep 2, 2020 |
#212 in Embedded development
646 downloads per month
Used in 3 crates
18KB
298 lines
std-embedded-nal
This crate implements the embedded-nal network traits for operating systems that support the standard library's network.
In that, it is to embedded-nal what linux-embedded-hal is to embedded-hal: A way to use libraries written for the bare-metal embedded world on Linux. (Just that network interfaces are better standardized than hardware access, so it should work on any system).
There is a co-maintained async version in [std-embedded-nal-async].
Usage
As the operating system's network stack is always available, it can be instanciated and used at any time without need for synchronization, roughly like this:
use embedded_nal::nb::block;
use std_embedded_nal::Stack;
use embedded_nal::UdpClient;
let message = [0x50, 0x01, 0x00, 0x00];
let mut stack = Stack::default();
let mut socket = stack.socket()?;
block!(stack.connect(&mut socket, "127.0.0.1:5683".parse()?)?);
block!(stack.send(&mut socket, &message)?);
See the CoAP and HTTP examples for full and working versions.
Performance and non-blocking
When using the regular embedded-nal
APIs,
the client main examples run use nb::block!
,
which means that there is busy looping until an event arrives
(which is bad in clients and terrible in servers).
The general expectation with these APIs based on nb
is that
users would know when to try again;
the UNIX version of the coapclient
example illustrates how that would probably be done.
(The setup around mio
and this library is relatively complex;
embedded implementations might get away with less code there.)
Maturity
This crate contains minimal working implementations the traits currently in embedded-nal.
Minimum Supported Rust Version
This crate is build-tested on stable Rust 1.77.0. That is largely following the embedded-nal MSRV. It might compile with older versions but that may change at any time.
Dependencies
~33KB