Dark Mode

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Cross-platform, full Bluetooth Mesh stack implemented in Rust

License

Notifications You must be signed in to change notification settings

AndrewGi/BluetoothMeshRust

Repository files navigation

Bluetooth Mesh Rust

!! WIP and API not stable until version 1.0 !!

Cross-platform, full Bluetooth Mesh stack implemented in Rust. Following the Bluetooth Mesh Spec Core v1.0 by SIG. Designed to work with any almost any BLE radio (uses https://github.com/AndrewGi/btle/ for platform dependent Bluetooth drivers). While a stack is provided by the library, all the primitives and objects needed to customize and create your own stack are provided.

This library is designed for #![no_std] in mind. However, because of the complexity of the Bluetooth Mesh Stack, std is required for the full_stack which uses async tokio for message handling and processing. #![no_std] is also disabled for now until rust-lang/rust#69033 hits nightly/stable.

The only heap allocations made during processing a message is allocating memory for the message at the access layer. Most Mesh PDUs are <31 bytes (to fit in a single BLE Advertisement) so the Network and Lower Transport Layer stores its data statically on the stack. Upper PDUs and above allow for allocation elsewhere than the stack (Upper Transport PDUs can be up to 380 bytes!) but a custom allocator/storage for the PDU can be genericly provided.

Examples

See Mesh CLI for an application example.

How the Stack works

About

Cross-platform, full Bluetooth Mesh stack implemented in Rust

Topics

Resources

Readme

License

GPL-3.0 license

Stars

Watchers

Forks

Releases

No releases published

Packages

Contributors

Languages