no-std support #55

deltronix · 2025-12-30T13:49:52Z

Removed dependency on std when the "std" feature is disabled

The library can now be compiled with the --no-default-features flag to enable no_std support. The target will have to specify a #[global_allocator] such as
embedded-alloc

Replace socket2::SockAddr dependency with core::net::SocketAddrV4/6

pub fn universe_to_ipv4_multicast_addr() now returns core::net::SocketAddrV4

pub fn universe_to_ipv6_multicast_addr() now returns core::net::SocketAddrV6

Implements the foundation for #42

bruingineer · 2025-12-30T20:12:56Z

Please update from main

bruingineer · 2025-12-30T21:19:27Z

src/packet.rs

    use super::*;
-    use std::net::{Ipv4Addr, Ipv6Addr, SocketAddrV4, SocketAddrV6};
+    use core::net::{Ipv4Addr, Ipv6Addr, SocketAddrV4, SocketAddrV6};
+    use socket2::SockAddr;


the tests should be adjusted to remove the socket2 dependency. Once that is gone, then the tests are also no_std.

+1. Honestly if core gives us what we need for initializing sockets, I'm in favor of just removing socket2 altogether.

That crate advertises itself as providing a nice cross-platform way to configure sockets with advanced options; if we're not making use of those options, fewer dependencies is faster compiles :)

As far as I can tell core::net only supplies the basic address types and does not do any socket initialization unfortunately. So for the receiver and source modules we'd still need something like it.

I have rewritten the tests in packet.rs without using socket2::SockAddr. Perhaps a #![cfg(feature = "std)] flag or similar should be used in the tests/ directory as they still depend on socket2?

The receiver and source use advanced socket features through socket2. Packet parsing does not make use of socket2 features, so packet parsing and packing could be no_std (+alloc) fairly easily.

Cargo.toml

Removed dependency on std when the "std" feature is disabled The library can now be compiled with the --no-default-features flag to enable no_std support. The target will have to specify a #[global_allocator] such as [embedded-alloc](https://docs.rs/embedded-alloc/latest/embedded_alloc/) Replace socket2::SockAddr dependency with core::net::SocketAddrV4/6 `pub fn universe_to_ipv4_multicast_addr()` now returns core::net::SocketAddrV4 `pub fn universe_to_ipv6_multicast_addr()` now returns core::net::SocketAddrV6

Dependencies related to the embedded example were removed

deltronix · 2025-12-31T10:42:33Z

I have merged the changes from main and removed the example dependencies from the root Cargo.toml. I also removed the socket2 usage from the packet.rs tests, which now pass with the --no-default-features flag.

However the tests in the tests directory still depend on socket2.

I have now also added my example code. And I feel like some things are missing as far as no_std functionality goes:

A convenient way to construct sACN packets
A convenient way to parse sACN packets. Especially the frames containing DMX data
defmt::Format implementations for the packets

Example code for an stm32f746g-disco development board. Listens on the discovery universe. Automatically connects to the discovered universes. Up to the multicast limit as set by the smoltcp feature flag. Prints received packets with defmt.

bruingineer · 2026-01-15T23:18:54Z

Cargo.toml

-authors = ["Lukas Schmierer <lukas.schmierer@lschmierer.de>", "Paul Lancaster <paul@lancasterzone.com>"]
+authors = [
+  "Lukas Schmierer <lukas.schmierer@lschmierer.de>",
+  "Paul Lancaster <paul@lancasterzone.com>",
+]
 documentation = "https://github.com/RustLight/sacn"
 repository = "https://github.com/RustLight/sacn"
 license = "MIT OR Apache-2.0"
 homepage = "https://github.com/RustLight/sacn"
 exclude = [
-    "documentation/*",
-    "further testing/*",
-    ".github/*",
-    ".travis.yml",
-    ".gitignore",
+  "documentation/*",
+  "further testing/*",
+  ".github/*",
+  ".travis.yml",
+  ".gitignore",


Remove formatting edits of unmodified code sections.

bruingineer · 2026-01-15T23:19:46Z

Cargo.toml

Add the added example to cargo.toml

bruingineer · 2026-01-15T23:20:46Z

src/error.rs

-        Uuid(#[from] uuid::Error),
+        Uuid(uuid::Error),


What is wrong with this #[from] compared to the one above for Utf8Error?

bruingineer · 2026-01-15T23:21:23Z

src/lib.rs

+#[cfg(feature = "std")]
+extern crate std;
+
+//use core::{fmt, fmt::Display};


Is this needed? Uncomment or delete the line.

bruingineer · 2026-01-15T23:22:03Z

src/lib.rs

 /// The errors within the sACN crate related to parse/pack errors.
 /// Error-chain is used for errors within the library to allow chaining errors together to provide more informative backtraces.
 /// This completely replaces the old error system (sACN crate version 0.4.4) which relied on a simple Enum model without proper backtraces.
+//#[cfg(feature = "std")]


Delete comment if not needed.

bruingineer · 2026-01-15T23:22:06Z

src/lib.rs

 pub mod sacn_parse_pack_error;

 /// The errors used within the sACN crate, parse/pack errors are seperated out into sacn_parse_pack_error.
+//#[cfg(feature = "std")]


Delete comment if not needed.

bruingineer reviewed Dec 30, 2025

View reviewed changes

stewartadam reviewed Dec 31, 2025

View reviewed changes

Cargo.toml Outdated Show resolved Hide resolved

stewartadam reviewed Dec 31, 2025

View reviewed changes

Cargo.toml Outdated Show resolved Hide resolved

deltronix added 3 commits December 31, 2025 11:14

Removed unused dependencies

470803e

Dependencies related to the embedded example were removed

Removed socket2::SockAddr from the tests in packet.rs

aee6108

deltronix force-pushed the no_std branch from 42f8c65 to aee6108 Compare December 31, 2025 10:15

deltronix force-pushed the no_std branch from 927eee3 to 3de001b Compare December 31, 2025 16:59

Example binary for embedded usage

1b05afe

Example code for an stm32f746g-disco development board. Listens on the discovery universe. Automatically connects to the discovered universes. Up to the multicast limit as set by the smoltcp feature flag. Prints received packets with defmt.

deltronix force-pushed the no_std branch from 3de001b to 1b05afe Compare December 31, 2025 17:05

bruingineer mentioned this pull request Jan 5, 2026

Version roadmap #48

Open

15 tasks

bruingineer reviewed Jan 15, 2026

View reviewed changes

no-std support #55

Are you sure you want to change the base?

no-std support #55

Uh oh!

Conversation

deltronix commented Dec 30, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

bruingineer commented Dec 30, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

deltronix Dec 31, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

deltronix commented Dec 31, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

deltronix commented Dec 30, 2025 •

edited

Loading

deltronix Dec 31, 2025 •

edited

Loading

deltronix commented Dec 31, 2025 •

edited

Loading