Skip to content

A Rust Host BLE stack with a future goal of qualification.

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE
MIT
LICENSE-MIT
Notifications You must be signed in to change notification settings

embassy-rs/trouble

Repository files navigation

trouble

CI

TrouBLE is a Bluetooth Low Energy (BLE) Host implementation written in Rust, with a future goal of qualification. The initial implementation was based on bleps but has been adopted to work with types and traits from bt-hci and adding support for more of the BLE specification such as L2CAP connection oriented channels.

What is a Host?

A BLE Host is one side of the Host Controller Interface (HCI). The BLE specification defines the software of a BLE implementation in terms of a controller (lower layer) and a host (upper layer).

These communicate via a standardized protocol, that may run over different transports such as as UART, USB or a custom in-memory IPC implementation.

The advantage of this split is that the Host can generally be reused for different controller implementations.

Hardware support

TrouBLE can use any controller that implements the traits from bt-hci. At present, that includes:

Current status

The implementation has the following functionality working:

  • Peripheral role - advertise as a peripheral and accept connections.
  • Central role - scan for devices and establish connections.
  • Basic GATT server supporting write, read, notifications
  • Basic GATT client supporting service and characteristic lookup and read + write
  • L2CAP CoC (Connection oriented Channels) with credit management (for both central and peripheral)

See the issues for a list of TODOs.

Minimum supported Rust version (MSRV)

Trouble is guaranteed to compile on stable Rust 1.80 and up. It might compile with older versions but that may change in any new patch release.

Examples

See examples for example applications for different BLE controllers.

  • nrf-sdc for the nRF52 based using the nrf-sdc crate.
  • serial-hci which runs on std using a controller attached via a serial port (Such as this Zephyr sample).
  • apache-nimble which uses the controller from the NimBLE stack through high-level bindings from the apache-nimble crate.
  • esp32 which uses the BLE controller in the esp-hal.
  • rp-pico-w which uses the BLE controller in the Raspberry Pi Pico W.

Since a lot of the examples demo the same BLE functionality, they only contain basic wiring specific to the BLE controller, and share the 'business logic' within the examples/apps folder.

License

Trouble is licensed under either of

at your option.

About

A Rust Host BLE stack with a future goal of qualification.

Resources

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE
MIT
LICENSE-MIT

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages