https://github.com/drogue-iot/embedded-tls

An Rust TLS 1.3 implementation for embedded devices.
https://github.com/drogue-iot/embedded-tls

Last synced: 2 months ago
JSON representation

An Rust TLS 1.3 implementation for embedded devices.

• Host: GitHub
• URL: https://github.com/drogue-iot/embedded-tls
• Owner: drogue-iot
• License: apache-2.0
• Created: 2020-08-25T19:12:26.000Z (almost 5 years ago)
• Default Branch: main
• Last Pushed: 2025-04-21T14:27:23.000Z (3 months ago)
• Last Synced: 2025-04-30T21:04:21.261Z (3 months ago)
• Language: Rust
• Homepage:
• Size: 4.84 MB
• Stars: 187
• Watchers: 6
• Forks: 31
• Open Issues: 16
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

• rust-embedded - embedded-tls - std environment. (no-std crates / WIP)
• awesome-embedded-rust - embedded-tls - std environment. (no-std crates / WIP)

README

        
# Embedded-TLS

[![CI](https://github.com/drogue-iot/embedded-tls/actions/workflows/ci.yaml/badge.svg)](https://github.com/drogue-iot/embedded-tls/actions/workflows/ci.yaml)

[![crates.io](https://img.shields.io/crates/v/embedded-tls.svg)](https://crates.io/crates/embedded-tls)

[![docs.rs](https://docs.rs/embedded-tls/badge.svg)](https://docs.rs/embedded-tls)

[![Matrix](https://img.shields.io/matrix/drogue-iot:matrix.org)](https://matrix.to/#/#drogue-iot:matrix.org)

Embedded-TLS is a Rust-native TLS 1.3 implementation that works in a no-std environment. The Rust crate was formerly known as `drogue-tls`. The

implementation is work in progress, but the [example clients](https://github.com/drogue-iot/embedded-tls/tree/main/examples) should work against the [rustls](https://github.com/ctz/rustls) echo server.

The client supports both async and blocking modes. By default, the `std` feature is enabled, but can be disabled for bare metal usage.

To use the async mode, import `embedded_tls::*`. To use the blocking mode, import `embedded_tls::blocking::*`.

Some features and extensions are not yet implemented, have a look at [open issues](https://github.com/drogue-iot/embedded-tls/issues).

Only supports writing/receiving one frame at a time, hence using a frame buffer larger than 16k is not currently needed.  You may use a lower frame buffer size, but there is no guarantee that it will be able to parse any TLS 1.3 frame.

## Community

* [Drogue IoT Matrix Chat Room](https://matrix.to/#/#drogue-iot:matrix.org)

* We have bi-weekly calls at 9:00 AM (GMT). [Check the calendar](https://calendar.google.com/calendar/u/0/[email protected]&pli=1) to see which week we are having the next call, and feel free to join!

* [Drogue IoT Forum](https://discourse.drogue.io/)

* [Drogue IoT YouTube channel](https://www.youtube.com/channel/UC7GZUy2hKidvY6V_3QZfCcA)

* [Follow us on Twitter!](https://twitter.com/DrogueIoT)