embedded-nal
| Crates.io | embedded-nal |
| lib.rs | embedded-nal |
| version | 0.9.0 |
| source | src |
| created_at | 2020-08-26 18:28:46.964223 |
| updated_at | 2024-09-24 11:37:37.303829 |
| description | A Network Abstraction Layer (NAL) for Embedded Systems |
| homepage | https://github.com/rust-embedded-community/embedded-nal |
| repository | https://github.com/rust-embedded-community/embedded-nal |
| max_upload_size | |
| id | 281062 |
| size | 39,573 |
all (github:rust-embedded-community:all)
documentation
README
embedded-nal
An Embedded Network Abstraction Layer
This crate defines a simple set of traits that can be implemented by almost any TCP/IP stack. This might be an on-chip stack like smoltcp, or it could be an off-chip TCP/IP stack on an AT modem.
API reference
How-to: add a new trait
This is the suggested approach to adding a new trait to embedded-nal
Research / Discussion
Ideally, before proposing a new trait, or set of traits, you should check for an existing issue suggesting the need for the trait, as well as any related works / use cases / requirements that are useful to consider in the design of the trait.
These issues will be labeled as discussion in the issue tracker.
Implementation / Demonstration
Proposed traits should then be implemented and demonstrated, either by forking embedded-nal or by creating a new crate with the intent of integrating this into embedded-nal once the traits have stabilized. You may find cargo workspaces and patch useful for the forking approach.
Proposing a trait
Once the trait has been demonstrated a PR should be opened to merge the new trait(s) into embedded-nal. This should include a link to the previous discussion issue.
If there is determined to be more than one alternative then there should be further discussion to
try to single out the best option. Once there is consensus this will be merged into the embedded-nal repository.
These issues / PRs will be labeled as proposals in the issue tracker.
Minimum Supported Rust Version (MSRV)
This crate is guaranteed to compile on stable Rust 1.77.0 and up. It might compile with older versions but that may change in any new patch release.
License
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.